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

# List your active webhook subscriptions.

`GET /v1/webhooks`

## Request

- Base URL: `https://logistics.api.cabify-sandbox.com`
- URL: `https://logistics.api.cabify-sandbox.com/v1/webhooks`
- Auth: HTTP bearer

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.
- `429`: Too many requests. This API is rate limited per account and per endpoint. A 429 is an expected condition rather than a failed request: back off and retry it. The limits are not the same for every endpoint and can change, so handle the status instead of hard-coding a rate. See the Limits and reliability guide.

---

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