> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.crowdchange.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get webhooks

> Retrieve a paginated list of every CrowdChange webhook subscription registered on your account, with target URL, subscribed events, and status.

## Query parameters

<ParamField query="q" type="string">
  Search term.
</ParamField>

<ParamField query="page" type="integer">
  Page number. Default: `1`
</ParamField>

<ParamField query="limit" type="integer">
  Number of results to return. Default: `10`
</ParamField>

## Response

Returns an array of objects with the following fields.

<ResponseField name="id" type="integer">
  Webhook ID.
</ResponseField>

<ResponseField name="url" type="string">
  Webhook URL.
</ResponseField>

<ResponseField name="signing_secret" type="string">
  Webhook-specific secret used to verify `CrowdChange-Webhook-Signature` on outbound deliveries. Store this value securely.
</ResponseField>

<ResponseField name="language" type="string">
  Webhook language. Allowed values: `en`, `fr`
</ResponseField>

<ResponseField name="created_at" type="string">
  Webhook creation date.
</ResponseField>

<ResponseField name="events" type="object[]">
  List of subscribed events.

  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      Event ID.
    </ResponseField>

    <ResponseField name="name" type="string">
      Event name
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Event creation date.
    </ResponseField>
  </Expandable>
</ResponseField>

**Other responses**

| Status | Description  |
| ------ | ------------ |
| `400`  | Bad Request  |
| `401`  | Unauthorized |
| `403`  | Forbidden    |

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": 1,
      "url": "https://demo.crowdchange.test/webhooks/handle",
      "signing_secret": "whsec_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ab",
      "language": "en",
      "created_at": "2024-01-01 16:00:03",
      "events": [
        {
          "id": 1,
          "name": "fundraiser_created",
          "created_at": "string"
        }
      ]
    }
  ]
  ```
</ResponseExample>