# List 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.

Endpoint: GET /api/subscriptions
Security: ApiKeyAuth

## Query parameters:

  - `limit` (integer)
    Maximum number of results (1-100)
    Example: 10

  - `offset` (integer)
    Number of results to skip

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)
    Example: "507f1f77bcf86cd799439011"

  - `data.entityType` (string, required)
    Enum: "contact", "company"

  - `data.entityId` (string, required)
    Example: "123456"

  - `data.signalTypes` (array, required)
    Example: ["promotion","companyChange"]

  - `data.url` (string, required)
    Example: "https://example.com/webhooks/lusha"

  - `data.name` (string)
    Example: "Contact Promotion Tracker"

  - `data.isActive` (boolean, required)
    Example: true

  - `data.blockReason` (string,null)
    Reason subscription was disabled (null if active)
    Example: "Max retries exceeded"

  - `data.blockedAt` (string,null)
    When subscription was disabled (null if active)
    Example: "2026-01-14T10:00:00.000Z"

  - `data.createdAt` (string, required)
    Example: "2026-01-14T10:00:00.000Z"

  - `data.updatedAt` (string, required)
    Example: "2026-01-14T10:00:00.000Z"

  - `pagination` (object, required)

  - `pagination.total` (integer, required)
    Total number of results
    Example: 100

  - `pagination.limit` (integer, required)
    Maximum results per page
    Example: 50

  - `pagination.offset` (integer, required)
    Number of results skipped

  - `pagination.hasMore` (boolean, required)
    Whether more results are available
    Example: true

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 500 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]