# List webhook endpoints

> List webhook endpoints: reference page for this CustomDomain™ API operation in the webhooks group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/webhooks/listWebhooks

## `GET https://api.customdomain.ai/v1/webhooks`

With an API key: endpoints across all the tenant's live apps (a test mode application's endpoints are left out unless `?app_id=` names it). With a test mode API key: that application's endpoints. With a widget JWT: the calling app's endpoints. Secrets are omitted.

### Authentication

`apiKey`, `widgetJWT`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `app_id` | query | string | no | Narrow to one application, which is how a live key reaches a test mode application's endpoints. |

### Responses

| Status | Description |
| --- | --- |
| `200` | Endpoints |
| `401` | Error envelope: {code, title, details}. |
| `503` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `webhooks` | array of object | yes |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.