# List events

Return a paginated list of the client's events, optionally filtered by subscription, event type, or creator.

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

## Query parameters:

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

  - `subscription_id` (integer)
    Return only events belonging to this subscription.

  - `event_type` (string)
    Filter events by type (e.g. 'new_post', 'bio_change').

  - `creator` (string)
    Filter events by creator handle (exact match).

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

## Response 200 fields (application/json):

  - `count` (integer, required)
    Total number of events 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)
    Events on the current page.

  - `results.id` (integer, required)

  - `results.event_type` (string, required)

  - `results.event_value` (object,null)

  - `results.creator` (object, required)

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

  - `results.creator.platform_id` (string, required)
    The creator's handle on the platform.

  - `results.date_occurance` (string, required)

  - `results.created_at` (string, required)

  - `results.delivery_status` (string)
    Delivery status of the event (pending/sending/sent/failed/retrying).

  - `results.latency_seconds` (string)
    Response time of the first successful delivery, in seconds.

  - `results.retries` (string)
    Total retry count across all delivery attempts.


## Response 400 fields

## Response 401 fields

## Response 422 fields