---
title: "List your active webhook subscriptions."
method: GET
path: "/v1/webhooks"
tags: ["webhooks"]
---

# List your active webhook subscriptions.

`GET /v1/webhooks`

Returns all active webhook subscriptions registered for your account.

## Response `200`

Webhook subscriptions retrieved successfully.

- ResponseWebhookSubscriptions
  - `subscriptions` ResponseWebhookSubscription[], required
    - `id` number, required — Internal identifier of the webhook subscription.
    - `hook` 'parcel', required — The event type this subscription listens to. Receive a notification for every individual parcel status change.
    - `callback_url` string, uri, required — Your endpoint URL. The API will send a POST request to this URL each time the subscribed event occurs.
    - `headers` Header[] — Custom headers included in every webhook request (e.g. for authentication).
      - `name` string, required — Header name
      - `value` string, required — Header value

## Other responses

- `401` — Unauthorized. Missing or invalid authentication token.

---

[API](https://skmtc.dev/cabify/apis/ride-hailing-api.md) · [All operations](https://skmtc.dev/cabify/apis/ride-hailing-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cabify/ride-hailing-api/revisions/8da1cb1270df/schema)