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

# Get list of callbacks by event subscription

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

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. 


## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `subscription_id` | string | Yes | ID of the subscription |

## 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 time. 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` |
| `filters:initiator_id` | string | No | Search for a string in initiator IDs. Format: `?filters=[{"_OR":[{"initiator_id ":{"type":"like","value":"21a28b47"}}]}]` |
| `filters:date` | string | No | Filter results by the timestamps of start time. 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]}}]` |

## Header Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `Content-Type` | string | No | application/json |

## Responses

### 200

List of callbacks sent for the event subscription.

**Example** (`Successful response`)

```json
{
  "data": [
    {
      "id": "5c2d2bb12ae4c2a8ba3ac6dd15df69ec2e3a500a",
      "duration": 0.0743,
      "entity_id": "c829fe1931ddd1eb4e5e8d5ebe2f049f702e3235",
      "event_name": "document.update",
      "entity_type": "document",
      "callback_url": "http://example.com/callback",
      "request_method": "post",
      "request_content": {
        "meta": {
          "event": "document.update",
          "timestamp": 1792672126,
          "environment": "https://api.signnow.com",
          "access_token": "********",
          "callback_url": "http://example.com/callback",
          "initiator_id": "c2fbe5919b42cc30f418c031665450d203c081a1"
        },
        "content": {
          "user_id": "c2fbe5919b42cc30f418c031665450d203c081a1",
          "document_id": "c829fe1931ddd1eb4e5e8d5ebe2f049f702e3235",
          "document_name": "Contract"
        }
      },
      "request_headers": [],
      "application_name": "My app",
      "request_end_time": 1792672130,
      "response_content": "{\"message\":\"Okay\",\"timestamp\":\"2026-10-22 12:28:50.004\"}",
      "request_start_time": 1792672130,
      "response_status_code": 200,
      "event_subscription_id": "317e7632eb3894b9310bc753336661b742ed193c",
      "event_subscription_active": true,
      "event_subscription_owner_email": "user@example.com"
    }
  ],
  "meta": {
    "pagination": {
      "count": 1,
      "links": [],
      "total": 1,
      "per_page": 15,
      "total_pages": 1,
      "current_page": 1
    }
  }
}
```

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




**Example** (`Authorization error`)

```json
{
  "code": 1537,
  "error": "invalid_token"
}
```

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

```json
{
  "errors": [
    {
      "code": 15006011,
      "message": "Incorrect 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": "Incorrect filter format, filter `type` must be a string."
    }
  ]
}
```

**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 initiator_id filter value`)

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

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

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

### 403

Request with token of another application

**Example** (`Request with token of another application`)

```json
{
  "errors": [
    {
      "message": "Access to the subscription data is not allowed"
    }
  ]
}
```

### 404

* Request with non-existing subscription_id
* Request with invalid subscription_id

**Example** (` Invalid subscription_id`)

```json
{
  "404": "Unable to find a route to match the URI: v2/dashboard/event-subscriptions/23@/callbacks/12345"
}
```

**Example** (`Non-existing subscription_id`)

```json
{
  "errors": [
    {
      "message": "UserEventSubscription `94XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX` not found"
    }
  ]
}
```

## Code Examples

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

### cURL

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

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