> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List events

> Returns all events across your account, sorted with the most recent first.

Returns a list of all events across your account. Events are sorted by timestamp, with the most recent appearing first.

Results include envelope, recipient, deliverable, and sender events.

### Query parameters

<ParamField query="type" type="enum">
  Filter by event type. For example, `envelope.completed` or `recipient.hard_bounced`.

  For the full list of event types, see:

  * [Envelope Events](/docs/api/resources/events/envelope-events)
  * [Recipient Events](/docs/api/resources/events/recipient-events)
  * [Deliverable Events](/docs/api/resources/events/deliverable-events)
  * [Sender Events](/docs/api/resources/events/sender-events)
</ParamField>

<ParamField query="limit" type="integer">
  The maximum number of objects to return. Minimum is `1`, maximum is `20`. Defaults to `20`.
</ParamField>

### Returns

Returns a `200 OK` status with a [paginated](/docs/api/pagination) list of [event objects](/docs/api/resources/events/object) on success, or an [error](/docs/api/errors) otherwise.

<RequestExample>
  ```json Request theme={null}
  // GET https://api.signatureapi.com/v1/events
  // X-API-Key: key_test_...
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  // HTTP Status Code 200

  {
    "links": {
      "next": "https://api.signatureapi.com/v1/events?cursor=seq_0iuY6H...",
      "previous": "https://api.signatureapi.com/v1/events?cursor=seq_87unYn..."
    },
    "data": [
      {
        "id": "evt_45b62ui33fCihBWpW2kWDa",
        "type": "envelope.completed",
        "timestamp": "2025-12-31T23:59:00.000Z",
        "data": {
          "object_id": "2dc5d4bb-5f4e-41a8-aea8-077a48587e31",
          "object_type": "envelope",
          "envelope_id": "2dc5d4bb-5f4e-41a8-aea8-077a48587e31",
          "envelope_metadata": {}
        }
      },
      {
        "id": "evt_7BFIYuMgWzJ1AHscS0RNxC",
        "type": "recipient.completed",
        "timestamp": "2025-12-31T23:58:59.000Z",
        "data": {
          "object_id": "re_00ZeZjRaXCgT30n1eBx53N",
          "object_type": "recipient",
          "envelope_id": "2dc5d4bb-5f4e-41a8-aea8-077a48587e31",
          "envelope_metadata": {},
          "recipient_type": "signer",
          "recipient_key": "client",
          "session_id": "ses_2X6eHBCL84MDGrLQX0mHI72"
        }
      },
      //...
    ]
  }
  ```
</ResponseExample>