---
title: "List Subscriptions"
method: GET
path: "/api/subscriptions"
tags: ["Webhooks"]
---

# List Subscriptions

`GET /api/subscriptions`

Returns all webhook subscriptions for your account with pagination support.

*Endpoint*: **(GET) https://api.lusha.com/api/subscriptions**

**Pagination:**
- Results are sorted by `createdAt` in descending order (newest first)
- Default limit: 10, max limit: 100
- Use `offset` for pagination through large result sets

> **Note:** The webhook `secret` is never returned in list responses for security.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of subscriptions retrieved successfully

- SubscriptionListResponse
  - `data` SubscriptionWithoutSecret[], required
    - `id` string, required
    - `entityType` 'contact' | 'company', required
    - `entityId` string, required
    - `signalTypes` string[], required
    - `url` string, uri, required
    - `name` string
    - `isActive` boolean, required
    - `blockReason` string, nullable — Reason subscription was disabled (null if active)
    - `blockedAt` string, date-time, nullable — When subscription was disabled (null if active)
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `pagination` PaginationResponse, required
    - `total` integer, required
    - `limit` integer
    - `offset` integer
    - `hasMore` boolean, required

## Other responses

- `400` — Bad request - invalid input data
- `401` — Unauthorized - invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/versions/4c51e40e3e67/schema)