# Get Subscription by ID

Returns a single webhook subscription by ID.

Endpoint: (GET) https://api.lusha.com/api/subscriptions/{id}

Endpoint: GET /api/subscriptions/{id}
Security: ApiKeyAuth

## Path parameters:

  - `id` (string, required)
    Subscription ID
    Example: "507f1f77bcf86cd799439011"

## Response 200 fields (application/json):

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

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

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

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

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

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

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

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

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

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

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

## 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 404 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"]