---
title: "List webhooks"
method: GET
path: "/webhooks"
tags: ["Webhook"]
---

# List webhooks

`GET /webhooks`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/webhooks`
- Auth: HTTP bearer

Returns a [cursor-paginated](https://docs.gocardless.com/docs/api-reference/data-conventions#cursor-pagination) list of your webhooks.

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `created_at` object
  - `gt` string, date-time: Limit to records created after the specified date-time.
  - `lt` string, date-time: Limit to records created before the specified date-time.
  - `gte` string, date-time: Limit to records created on or after the specified date-time.
  - `lte` string, date-time: Limit to records created on or before the specified date-time.
- `successful` union
  - 'true' | 'false'
  - boolean
- `is_test` union
  - 'true' | 'false'
  - boolean

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- WebhookMultiResourceResponse
  - `webhooks` Webhook[]
    - `id` string: Unique identifier, beginning with "WB".
    - `created_at` string, date-time: Fixed [timestamp](https://docs.gocardless.com/docs/api-reference/data-conventions#dates-and-times), recording when this resource was created.
    - `url` string: URL the webhook was POST-ed to
    - `request_headers` WebhookRequestHeaders: The request headers sent with the webhook
    - `request_body` string: The body of the request sent to the webhook URL
    - `response_code` integer, nullable: The response code from the webhook request
    - `response_body` string, nullable: The body of the response from the webhook URL
    - `response_body_truncated` boolean, nullable: Boolean value indicating the webhook response body was truncated
    - `response_headers` WebhookResponseHeaders, nullable: The headers sent with the response from the webhook URL
    - `response_headers_content_truncated` boolean, nullable: Boolean indicating the content of response headers was truncated
    - `response_headers_count_truncated` boolean, nullable: Boolean indicating the number of response headers was truncated
    - `is_test` boolean: Boolean value showing whether this was a demo webhook for testing
    - `successful` boolean: Boolean indicating whether the request was successful or failed
  - `meta` WebhookPaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

[API](https://skmtc.dev/gocardless/apis/gocardless-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-api/revisions/4dd3dae45364?raw)