---
title: "Get a webhook subscription"
method: GET
path: "/v2/webhook-subscriptions/{subscription_id}"
tags: ["Webhooks"]
---

# Get a webhook subscription

`GET /v2/webhook-subscriptions/{subscription_id}`

## Request

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

Get a specific webhook subscription by its ID. A 404 is returned when
the subscription does not exist, its source is not readable, or its
webhook has since been deleted.

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

## Path parameters

- `subscription_id` string, required: A universally unique identifier (base64-encoded opaque string).

## Response `200`

A webhook subscription object

- WebhookSubscription: A subscription delivers one event from one prompt, evaluator, task or space to one webhook. A webhook that should receive several events from the same resource has one subscription per event.
  - `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

## Other responses

- `400`: Invalid request
- `401`: Authentication is required
- `404`: Not found
- `429`: Rate limit exceeded

## Changes

> 49 revisions in range; 1 not diffed.

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

[Operation history](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/webhook-subscriptions/:subscription_id/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/83b6feb52a3e?raw)