---
title: "Get list of callbacks by event subscription"
method: GET
path: "/v2/event-subscriptions/{subscription_id}/callbacks"
---

# Get list of callbacks by event subscription

`GET /v2/event-subscriptions/{subscription_id}/callbacks`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/event-subscriptions/{subscription_id}/callbacks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/event-subscriptions/:subscription_id/callbacks/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to get the history of callbacks sent for an event subscription.

The results can be filtered and sorted. If the `sort` parameter is not indicated, the results are sorted by the `start_time` in descending order. The `filters` and `sort` parameters need URL-encoding.

## Response `200`

List of callbacks sent for the event subscription.

- object
  - `data` object[]: List of callbacks.
    - `id` string: ID of the callback.
    - `duration` number: Duration of the callback request, in seconds.
    - `entity_id` string: ID of the entity (document, document group, or user) the event occurred on.
    - `event_name` string: Name of the event, for example `document.update`.
    - `entity_type` string: Type of the entity: `document`, `document_group`, or `user`.
    - `callback_url` string: URL the callback was sent to.
    - `request_method` string: HTTP method of the callback request.
    - `request_content` object: Payload sent to the callback URL.
      - `meta` object: Event metadata.
        - `event` string: Name of the event.
        - `timestamp` integer: Unix timestamp of the event.
        - `environment` string: API host the event came from.
        - `access_token` string: Access token placeholder. Always masked as `********`.
        - `callback_url` string: Callback URL.
        - `initiator_id` string: ID of the user who triggered the event.
      - `content` object: Event data. The fields depend on the event; for document events they include `document_id`, `document_name`, and `user_id`.
    - `request_headers` object: Custom headers sent with the callback, as key-value pairs. An empty array when no headers are set.
    - `application_name` string: Name of the application that owns the event subscription.
    - `request_end_time` integer: Unix timestamp of when the callback request ended.
    - `response_content` string: Body of the response the callback URL returned, as a string.
    - `request_start_time` integer: Unix timestamp of when the callback request started.
    - `response_status_code` integer: HTTP status code the callback URL returned.
    - `event_subscription_id` string: ID of the event subscription.
    - `event_subscription_active` boolean: Whether the event subscription is active.
    - `event_subscription_owner_email` string: Email address of the owner of the event subscription.
  - `meta` object: Pagination details.
    - `pagination` object: Pagination information for the result set.
      - `count` integer: Number of items on the current page.
      - `links` object: Links to the adjacent pages. An empty array when there are no other pages; otherwise an object with `next` and/or `previous` URLs.
      - `total` integer: Total number of items.
      - `per_page` integer: Maximum number of items per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Number of the current page.

## Other responses

- `400`: * Token issue. * Incorrect filter format (each filter must contain `type` and `value` fields). * Incorrect filter expression (must be a string). * Incorrect `code` or `date` filter expression (must be `"type": "between"`). * Incorrect `initiator_id` filter expression (must be `"type": "like"`). * Incorrect `code` or `date` filter value (must be an array of 2 integers). * Incorrect `initiator_id` filter value (must be a string).
- `403`: Request with token of another application.
- `404`: * Request with non-existing subscription_id. * Request with invalid subscription_id.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)