---
title: "Retrieve all subscriptions"
method: GET
path: "/tracking-push/subscribers"
tags: ["Webhooks"]
---

# Retrieve all subscriptions

`GET /tracking-push/subscribers`

Retrieve a list of all subscriptions associated with the client.

## Response `200`

Successful response containing a list of subscriptions.

- object
  - `current_page` integer — The current page of the paginated result set.
  - `last_page` integer — The last page of the paginated result set.
  - `per_page` integer — The number of items per page.
  - `total` integer — The total number of subscription items available.
  - `items` object[] — The array of subscription items.
    - `id` string — The public identifier of the subscription.
    - `type` string — The type of subscription. Can be `individual`, `numbers`, `legal`, `recipientLegal` or `creator`.
    - `url` string, uri — The callback URL for the webhook notifications.
    - `isActive` boolean — Indicates if the subscription is currently active.
    - `is_active` boolean — Deprecated. Legacy field kept for backward compatibility. Use `isActive` instead.
    - `phone` string — The phone number associated with the subscription.
    - `cid` string — Unique user identifier
    - `eventTypes` string[] — The list of event types the subscription is interested in.
    - `event_types` string[] — Deprecated. Legacy field kept for backward compatibility. Use `eventTypes` instead.
    - `sendWarnings` boolean — Indicates whether email warnings are sent for incorrect endpoint operations.
    - `send_warnings` boolean — Deprecated. Legacy field kept for backward compatibility. Use `sendWarnings` instead.
    - `warningEmail` string, email — The email address used for sending warnings.
    - `warning_email` string, email — Deprecated. Legacy field kept for backward compatibility. Use `warningEmail` instead.
    - `contentType` string — Specifies the content type used for webhook request payloads. The default value is `application/json`.
    - `companyTins` string[] — The list of company tax identification numbers of a legal entity associated with the subscription.
    - `company_tins` string[] — Deprecated. Legacy field kept for backward compatibility. Use `companyTins` instead.
    - `secretToken` string — Webhook authorization token used to validate incoming webhook requests. 🔸The token is optional and, if provided, must consist only of alphanumeric characters.
    - `secret_token` string — Deprecated. Legacy field kept for backward compatibility. Use `secretToken` instead.
    - `secretTokenHeaderName` string — Header name used to transmit the `secretToken` in webhook requests. If `secret_token_header_name` is provided and is not null, its value is used as the header name for transmitting the `secretToken`.</br> If `secret_token_header_name` is not provided or is set to null, the default header name `X-NP-Key` is used. 🔸If provided, the header name must consist only of Latin letters, digits, and hyphens, must not start or end with a hyphen, and must not contain spaces or other special characters.
    - `secret_token_header_name` string — Deprecated. Legacy field kept for backward compatibility. Use `secretTokenHeaderName` instead.
    - `updatedAt` string, datetime — The timestamp when the subscription was last updated.
    - `updated_at` string, datetime — Deprecated. Legacy field kept for backward compatibility. Use `updatedAt` instead.
    - `createdAt` string, datetime — The timestamp when the subscription was created.
    - `created_at` string, datetime — Deprecated. Legacy field kept for backward compatibility. Use `createdAt` instead.
    - `numbers` string[] — The list of tracking numbers associated with the subscription.

## Other responses

- `401` — Unauthorized
- `404` — The specified resource was not found
- `422` — Validation error
- `503` — Connection time-out

---

[API](https://skmtc.net/novapost/apis/api-nova-post.md) · [All operations](https://skmtc.net/novapost/apis/api-nova-post/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novapost/api-nova-post/revisions/60e380005037/schema)