---
title: "Get list of callbacks"
url: "https://docs.signnow.com/docs/callbacks-info/operations/get-v2-event-subscriptions-callbacks"
type: "endpoint"
section: "callbacks-info"
slug: "callbacks-info/operations/get-v2-event-subscriptions-callbacks"
method: "GET"
path: "/v2/event-subscriptions/callbacks"
operation_id: "get-v2-event-subscriptions-callbacks"
authorization: "bearer"
---

# Get list of callbacks

`GET /v2/event-subscriptions/callbacks`

Allows users to get the list of all webhook events (events history).

The results can be filtered and sorted. If the `sort` parameter is not indicated, the results are sorted by `start_time` in descending order.

## Authorization

bearer

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `sort:end_time` | string | No | Sort results by the end time. Possible values: asc, desc. Format: `?sort[end_time]=desc` |
| `sort:start_time` | string | No | Sort results by the start type. Possible values: asc, desc. Format: `?sort[start_time]=desc` |
| `sort:code` | string | No | Sort results by the response code. Possible values: asc, desc. Format: `?sort[code]=desc` |
| `sort:event` | string | No | Sort results by the specific type of event (from A to Z). Possible values: asc, desc. Format: `?sort[event]=desc` |
| `sort:application` | string | No | Sort results by the application name (from A to Z). Possible values: asc, desc. Format: `?sort[application]=desc` |
| `filters:entity_id, callback_url, initiator_id` | string | No | Search for a string in entity IDs, callback URLs, and initiator IDs. Format: `?filters=[{"_OR":[{"entity_id":{"type":"like","value":"21a28b47"}},{"callback_url":{"type":"like","value":"21a28b47"}},{"initiator_id":{"type":"like","value":"21a28b47"}}]}]` |
| `filters:date` | string | No | Filter results by the timestamps. Format: `?filters=[{"date":{"type":"between","value":[1580719773,1580720509]}}]` |
| `filters:code` | string | No | Filter results by the response codes. Format: `?filters=[{"code":{"type": "between", "value":[199,299]}}]` |
| `filters:event` | string | No | Filter results by the specific type of event. Format: `?filters=[{"event":{"type": "in", "value":["document.create", "document.update"]}}]` |
| `filters:event_type` | string | No | Filter results by the event type. Possible values: 'user', 'document', 'document_group'. Format: `?filters=[{"event_type":{"type": "in", "value":["user", "document", "document_group"]}}]` |
| `filters:application` | string | No | Filter results by the application. Format: `?filters=[{"application":{"type": "in", "value":["applicationUniqueId1", "applicationUniqueId2"]}}]` |

## Request Body

**Schema**

```json
{
  "type": "object"
}
```

## Responses

### 200

Correct request.

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


**Example** (`Incorrect filter format`)

```json
{
  "errors": [
    {
      "code": 15006011,
      "message": "Invalid filter format, filter must have `type` and `value` fields."
    }
  ]
}
```

**Example** (`Incorrect code filter value`)

```json
{
  "errors": [
    {
      "code": 15006015,
      "message": "The `code` filter value must be of type array with 2 integer."
    }
  ]
}
```

**Example** (`Incorrect date filter value`)

```json
{
  "errors": [
    {
      "code": 15006018,
      "message": "The `date` filter value must be of type array with 2 integer."
    }
  ]
}
```

**Example** (`Incorrect filter expression`)

```json
{
  "errors": [
    {
      "code": 15006012,
      "message": "Invalid filter format, filter `type` must be a string."
    }
  ]
}
```

**Example** (`Incorrect event filter value`)

```json
{
  "errors": [
    {
      "code": 15006033,
      "message": "The `event` filter value must be an array of strings."
    }
  ]
}
```

**Example** (`Incorrect code filter expression`)

```json
{
  "errors": [
    {
      "code": 15006013,
      "message": "The `code` filter expression must be equal to `between`."
    }
  ]
}
```

**Example** (`Incorrect date filter expression`)

```json
{
  "errors": [
    {
      "code": 15006016,
      "message": "The `date` filter expression must be equal to `between`."
    }
  ]
}
```

**Example** (`Incorrect entity_id filter value`)

```json
{
  "errors": [
    {
      "code": 15006020,
      "message": "The `entity_id` filter value must be a string."
    }
  ]
}
```

**Example** (`Incorrect event filter expression`)

```json
{
  "errors": [
    {
      "code": 15006031,
      "message": "The `event` filter expression must be equal to `in`"
    }
  ]
}
```

**Example** (`Incorrect event filter value item`)

```json
{
  "errors": [
    {
      "code": 15006034,
      "message": "The `event` must be one of valid events."
    }
  ]
}
```

**Example** (`Incorrect event_type filter value`)

```json
{
  "errors": [
    {
      "code": 15006029,
      "message": "The `event_type` filter value must be an array of strings."
    }
  ]
}
```

**Example** (`Incorrect application filter value`)

```json
{
  "errors": [
    {
      "code": 15006023,
      "message": "The `application` filter value should be an array of strings."
    }
  ]
}
```

**Example** (`Incorrect callback_url filter value`)

```json
{
  "errors": [
    {
      "code": 15006025,
      "message": "The `callback_url` filter value must be a string."
    }
  ]
}
```

**Example** (`Incorrect initiator_id filter value`)

```json
{
  "errors": [
    {
      "code": 15006027,
      "message": "The `initiator_id` filter value must be a string."
    }
  ]
}
```

**Example** (`Incorrect entity_id filter expression`)

```json
{
  "errors": [
    {
      "code": 15006019,
      "message": "The `entity_id` filter expression must be equal to `like`."
    }
  ]
}
```

**Example** (`Incorrect event_type filter expression`)

```json
{
  "errors": [
    {
      "code": 15006037,
      "message": "The `event_type` filter expression must be equal to `in`."
    }
  ]
}
```

**Example** (`Incorrect event_type filter value item`)

```json
{
  "errors": [
    {
      "code": 15006030,
      "message": "The `event_type` must be one of 'document', 'document_group', 'user', 'template'."
    }
  ]
}
```

**Example** (`Incorrect application filter expression`)

```json
{
  "errors": [
    {
      "code": 15006021,
      "message": "The `application` filter expression must be equal to `in`."
    }
  ]
}
```

**Example** (`Incorrect application filter value item`)

```json
{
  "errors": [
    {
      "code": 15006036,
      "message": "The `application` filter item length must be 40 and it should contain only characters in [a-z0-9]."
    }
  ]
}
```

**Example** (`Incorrect callback_url filter expression`)

```json
{
  "errors": [
    {
      "code": 15006024,
      "message": "The `callback_url` filter expression must be equal to `like`."
    }
  ]
}
```

**Example** (`Incorrect initiator_id filter expression`)

```json
{
  "errors": [
    {
      "code": 15006026,
      "message": "The `initiator_id` filter expression must be equal to `like`."
    }
  ]
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/v2/event-subscriptions/callbacks" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/callbacks-info/operations/get-v2-event-subscriptions-callbacks*