---
title: "List webhook subscriptions"
method: GET
path: "/v2/webhook-subscriptions"
tags: ["Webhooks"]
---

# List webhook subscriptions

`GET /v2/webhook-subscriptions`

## Request

- Base URL: `https://api.arize.com`
- URL: `https://api.arize.com/v2/webhook-subscriptions`
- Auth: HTTP bearer

List webhook subscriptions attached to prompts, evaluators, tasks and
spaces the caller can read, most recently created first. To list one
source, provide both `source_type` and `source_id`; providing only one
returns a 400. An unfiltered list returns a 403 when the caller can read
no prompt, evaluator or task at all.

Each subscription delivers one event to one webhook, so a webhook that
receives several events from the source appears once per event.
Subscriptions whose webhook has since been deleted, and task
subscriptions on tasks the caller cannot read, are omitted after the
page is read, so a page may hold fewer than `limit` items, or none,
while `has_more` is still `true`. Keep paging until `has_more` is
`false`.

When filtering by source, a 404 is returned when the source does not
exist or is not readable.

<Warning>This endpoint is in alpha, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Warning>

## Query parameters

- `source_type` 'PROMPT' | 'EVALUATOR' | 'ONLINE_TASK' | 'SPACE': The kind of resource a webhook subscription is attached to. - `PROMPT` — `source_id` is a prompt id. Prompt events apply. - `EVALUATOR` — `source_id` is an evaluator id. Evaluator events apply. - `ONLINE_TASK` — `source_id` is an evaluation task id. Task run events apply. - `SPACE` — `source_id` is a space id. Task run events apply to every evaluation task in the space, including tasks created later.
- `source_id` string: A universally unique identifier (base64-encoded opaque string).
- `limit` integer
- `cursor` string

## Response `200`

Returns a list of webhook subscriptions, most recently created first

- ListWebhookSubscriptionsResponse
  - `subscriptions` WebhookSubscription[], required: A list of webhook subscriptions, most recently created first
    - `id` string, required: A universally unique identifier (base64-encoded opaque string).
    - `webhook_id` string, required: A universally unique identifier (base64-encoded opaque string).
    - `source_type` 'PROMPT' | 'EVALUATOR' | 'ONLINE_TASK' | 'SPACE', required: The kind of resource a webhook subscription is attached to. - `PROMPT` — `source_id` is a prompt id. Prompt events apply. - `EVALUATOR` — `source_id` is an evaluator id. Evaluator events apply. - `ONLINE_TASK` — `source_id` is an evaluation task id. Task run events apply. - `SPACE` — `source_id` is a space id. Task run events apply to every evaluation task in the space, including tasks created later.
    - `source_id` string, required: A universally unique identifier (base64-encoded opaque string).
    - `event` 'PROMPT_VERSION_CREATED' | 'PROMPT_VERSION_LABELED' | 'PROMPT_VERSION_UNLABELED' | 'EVALUATOR_VERSION_CREATED' | 'ONLINE_TASK_RUN_FAILED', required: An event that a webhook can subscribe to. - `PROMPT_VERSION_CREATED` — a new version of the prompt was created. - `PROMPT_VERSION_LABELED` — a label was added to a version of the prompt. - `PROMPT_VERSION_UNLABELED` — a label was removed from a version of the prompt. - `EVALUATOR_VERSION_CREATED` — a new version of the evaluator was created. - `ONLINE_TASK_RUN_FAILED` — a run of an evaluation task failed, or wrote some evaluations and then stopped on an error. Sent once when a task starts failing and again each time the cause changes. Prompt events are valid only for `PROMPT` sources, evaluator events only for `EVALUATOR` sources, and task run events only for `ONLINE_TASK` and `SPACE` sources.
    - `created_at` string, date-time, required: Timestamp for when the subscription was created
  - `pagination` PaginationMetadata, required: Cursor-based pagination metadata. Use `next_cursor` in the subsequent request's `cursor` query parameter.
    - `next_cursor` string: Opaque cursor for fetching the next page. Treat as an unreadable token. Present when `has_more` is true; omitted when `has_more` is false.
    - `has_more` boolean, required: True if another page of results is available.

## Other responses

- `400`: Invalid request
- `401`: Authentication is required
- `403`: Insufficient permissions to access this resource
- `404`: Not found
- `429`: Rate limit exceeded

## Changes

> 48 revisions in range; 1 not diffed.

- **2026-10-23** `74723b1c4847`: 3 warning, 2 info
  - added the new `ONLINE_TASK` enum value to the `subscriptions/items/source_type/allOf[#/components/schemas/WebhookSourceType]/` response property for the response status `200`
  - added the new `ONLINE_TASK_RUN_FAILED` enum value to the `subscriptions/items/event/allOf[#/components/schemas/WebhookEventType]/` response property for the response status `200`
  - added the new `SPACE` enum value to the `subscriptions/items/source_type/allOf[#/components/schemas/WebhookSourceType]/` response property for the response status `200`
  - added the new enum value `ONLINE_TASK` to the `query` request parameter `source_type`
  - …1 more
- **2026-09-12** `2a4c8244d07b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/webhook-subscriptions/get.md)

---

[API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) - [All operations](https://skmtc.dev/arize-ai/apis/arize-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arize-ai/apis/arize-rest-api/revisions/22ad4acd3cbb?raw)