# List subscriptions

Return a paginated list of the client's social-listening subscriptions, optionally filtered by type. The response includes a summary block with aggregate counts.

Endpoint: GET /public/v1/social/listening/subscription/
Version: 1.0.0
Security: Bearer

## Query parameters:

  - `page` (integer)
    Page number (1-based) for the paginated result.

  - `page_size` (integer)
    Number of results to return per page. Defaults to 10.

## Response 200 fields (application/json):

  - `count` (integer, required)
    Total number of subscriptions matching the filter.

  - `next` (string,null)
    URL of the next page, or null on the last page.

  - `previous` (string,null)
    URL of the previous page, or null on the first page.

  - `results` (array, required)
    Subscriptions on the current page.

  - `results.id` (integer, required)

  - `results.name` (string)

  - `results.subscription_type` (string, required)

  - `results.platform` (string, required)
    The creator's social media platform.

  - `results.event_type` (string, required)

  - `results.status` (string, required)

  - `results.paused_reason` (string)

  - `results.filters` (object,null)

  - `results.interval` (string)
    Polling interval for this subscription's event type.

  - `results.notify_endpoints` (array, required)
    Endpoints the subscription's events are delivered to.

  - `results.notify_endpoints.id` (integer, required)
    Notify endpoint identifier.

  - `results.notify_endpoints.destination` (string, required)
    Delivery destination (e.g. the webhook URL).

  - `results.notify_endpoints.notify_type` (string, required)
    Delivery type of the endpoint (e.g. 'api').

  - `results.notify_endpoints.created_at` (string, required)
    When the endpoint was created.

  - `results.source_lists` (array, required)
    Discovery lists feeding creators into the subscription.

  - `results.source_lists.id` (integer, required)
    Discovery list ID.

  - `results.source_lists.name` (string, required)
    Discovery list name.

  - `results.sample_creators` (string)
    Up to 3 creators (handle + avatar) attached to the subscription.

  - `results.creator_count` (string)
    Total number of creators attached to the subscription.

  - `results.delivery_health` (string)
    Delivery counters (total, successful, and failed deliveries).

  - `results.last_event_at` (string)
    Timestamp of the most recent event for this subscription.

  - `results.credits_spent` (string, required)
    Lifetime listening credits attributed to this subscription, accrued daily as 0.3 × its active creators (gross per-subscription). May exceed the deduplicated amount actually charged to the billing scope when creators are shared across subscriptions.

  - `results.created_at` (string, required)

  - `results.updated_at` (string, required)

  - `summary` (object, required)

  - `summary.active_subscriptions` (integer, required)
    Number of subscriptions currently active (respects the 'type' filter).

  - `summary.deliveries_24h` (object, required)

  - `summary.deliveries_24h.total` (integer, required)
    Deliveries attempted in the last 24 hours.

  - `summary.deliveries_24h.successful` (integer, required)
    Successful deliveries in the last 24 hours.

  - `summary.deliveries_24h.failed` (integer, required)
    Failed deliveries in the last 24 hours.

  - `summary.success_rate` (number,null)
    All-time successful-delivery percentage, or null when there have been no deliveries.

  - `summary.avg_detection_latency_seconds` (number,null)
    Average time from detection to successful delivery, in seconds, or null when unavailable.


## Response 400 fields

## Response 401 fields

## Response 422 fields