---
title: "Get list of callbacks"
method: GET
path: "/v2/event-subscriptions/callbacks"
---

# Get list of callbacks

`GET /v2/event-subscriptions/callbacks`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/event-subscriptions/callbacks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/event-subscriptions/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 webhook callbacks sent for their event subscriptions. Each item contains the event, the callback request and the response returned by the callback URL.

**Notes**

* The results can be filtered and sorted with the `filters` and `sort` query parameters.
* If `sort` is not set, the results are sorted by `start_time` in descending order.
* The results are paginated. Use the links in `meta.pagination.links` to get the adjacent pages.

## Request body

- object

## Response `200`

Returns a paginated list of callback requests sent for the user's event subscriptions, with request and response details for each.

- object
  - `data` object[]: List of callback requests.
    - `id` string: ID of the callback request.
    - `duration` number: Time it took to complete the callback request, in seconds.
    - `entity_id` string: ID of the entity the event subscription is attached to: a document, document group or user.
    - `event_name` string: Name of the event that triggered the callback, for example `document_group.update`.
    - `entity_type` string: Type of the entity the event subscription is attached to, for example `document`, `document_group` or `user`.
    - `callback_url` string: URL the callback request was sent to.
    - `request_method` string: HTTP method of the callback request, for example `post`.
    - `request_content` object: Body of the callback request.
      - `meta` object: Event metadata.
        - `event` string: Name of the event.
        - `timestamp` integer: Unix timestamp of when the event occurred.
        - `environment` string: Base URL of the SignNow API environment where the event occurred.
        - `access_token` string: Access token included in the callback. Masked in the callback log.
        - `callback_url` string: URL the callback request was sent to.
        - `initiator_id` string: ID of the user who initiated the event.
      - `content` object: Event-specific payload. The set of fields depends on the event, for example `group_id`, `group_invite_id`, `status` and `step_order` for document group invite events.
    - `request_headers` object[]: Custom headers sent with the callback request. Empty if the event subscription has no custom headers.
    - `application_name` string: Name of the application that owns the event subscription.
    - `request_end_time` integer: Unix timestamp of when the response to the callback request was received.
    - `response_content` string: Body of the response returned by the callback URL, as a string.
    - `request_start_time` integer: Unix timestamp of when the callback request was sent.
    - `response_status_code` integer: HTTP status code returned by the callback URL.
    - `event_subscription_id` string: ID of the event subscription that triggered the callback.
    - `event_subscription_active` boolean: Whether the event subscription is currently active.
    - `event_subscription_owner_email` string: Email address of the event subscription owner.
  - `meta` object: Response metadata.
    - `pagination` object: Pagination details.
      - `count` integer: Number of callbacks on the current page.
      - `links` object: Links to the adjacent pages. Empty if there is only one page.
        - `next` string: URL of the next page.
        - `previous` string: URL of the previous page.
      - `total` integer: Total number of callbacks that match the request.
      - `per_page` integer: Maximum number of callbacks per page.
      - `total_pages` integer: Total number of pages.
      - `current_page` integer: Number of the current page.

## Other responses

- `400`: * Incorrect filter format (each filter must contain type and value fields). * Incorrect filter expression (must be a string). * Incorrect `application`, `event`, or `event_type` filter expression (must be `"type": "in"`). * Incorrect `code` or `date` filter expression (must be `"type": "between"`). * Incorrect `entity_id`, `callback_url`, or `initiator_id` filter expression (must be `"type": "like"`). * Incorrect `application`, `event_type`, or `event` filter value (must be an array of strings). * Incorrect `application` filter value item (must be 40 symbols long or shorter and can contain only lowercase latin letters and digits). * Incorrect `event_type` filter value item (allowed values are `document`, `document_group`, `user`, and `template`). * Incorrect `event` filter value item (allowed values are listed [here](/docs/guides-webhooks#entity-events)). * Incorrect `code` or `date` filter value (must be an array of 2 integers). * Incorrect `entity_id`, `callback_url`, or `initiator_id` filter value (must be a string).

---

[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)