# Recent events (newest first, 30-day retention)

Source: https://docs.usetone.ai/reference/events/list

> The reconciliation path when a webhook delivery was missed, and the debugging path for "what exactly did Tone send".

`GET /v1/events`
The reconciliation path when a webhook delivery was missed, and the debugging path for "what exactly did Tone send". Deliveries are at-least-once and unordered, so dedupe on the event id.

Requires the `read` scope.

## Parameters

| Name | In | | Meaning |
|---|---|---|---|
| `limit` | query | optional | How many results to return. 1-100, defaulting to 25. |
| `type` | query | optional | Only events of this type, for example call.completed. Treat the set as open — new types are added without notice. |

## Response



### Example response

```json
{
  "data": [
    {
      "createdAt": "2026-08-25T09:14:22Z",
      "delivery": {
        "attempts": 0,
        "deliveredAt": "2026-08-25T09:14:03Z",
        "endpointId": "2b7c1d90-4e5f-4a6b-8c9d-0e1f2a3b4c5d",
        "lastStatus": 0,
        "status": "pending"
      },
      "id": "9f1c2d84-4e3a-4f6c-b902-7d1e8a33c451",
      "subjectId": "9f1c2d84-4e3a-4f6c-b902-7d1e8a33c451",
      "subjectType": "call",
      "type": "call.initiated"
    }
  ]
}
```