# signing.events.list

List the audit events of one envelope: created, prepared, sent, email accepted/delivered, viewed, code sent, incorrect code, link locked or unlocked, verified, consented, signed, declined, reminded, resent, voided, expired, finalizing stopped or restarted, completed, downloaded. order oldest (default) pages forward with afterId; order newest pages back from the latest event with beforeId. Returns hasMore.

`GET | POST /api/v1/accounting/signing.events.list`

Permissions: `accounting:read` · Roles: admin, finance

MCP tool: `accounting_signing_events_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `envelopeId` | string (ID) | Yes | The ID of a document sent for signature, from signing.envelopes.list. |
| `order` | enum |  | One of: `oldest`, `newest`. Default `"oldest"`. |
| `afterId` | integer |  | 0 to 9007199254740991. Default `0`. |
| `beforeId` | integer |  | 1 to 9007199254740991. |
| `limit` | integer |  | How many results to return at most. 1 to 500. Default `200`. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/signing.events.list \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'envelopeId=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'
```

Reference page: https://app.getoatmilk.com/docs/api/signing.events.list