API reference

Events

What happened to your documents in the last 90 days. The same events webhooks deliver.

Endpoints · 2

GET List events
GET Retrieve an event

The object

Field	Type	Description
`id`	string	Unique ID, starting with evt_.
`object`	string	Always "event".
`type`	string	See Webhook events.
`created_at`	timestamp
`data`	object	data.object is the document at the time of the event; recipient events add recipient_id.

GET/events

List events

Newest first, last 90 days.

Parameter	Type		Description
`limit`	integer	optional	How many objects to return, 1 to 100. Default 20.
`starting_after`	string	optional	The next_cursor from the previous page. Leave it out for the first page.
`type`	string	optional	One event type.
`document_id`	string	optional	Events about one document.

Request

bash

curl "https://api.esorasign.com/v1/events?type=document.completed" \
  -H "Authorization: Bearer $ESORA_API_KEY"

Response

json

{ "object": "list", "data": [ { "id": "evt_5ydfhl3TvtnythpZPPPP6U", "object": "event", "type": "document.completed", "...": "..." } ], "has_more": false, "next_cursor": null }

GET/events/{id}

Retrieve an event

Request

bash

curl "https://api.esorasign.com/v1/events/evt_5ydfhl3TvtnythpZPPPP6U" \
  -H "Authorization: Bearer $ESORA_API_KEY"

Response

json

{
  "id": "evt_5ydfhl3TvtnythpZPPPP6U",
  "object": "event",
  "type": "recipient.signed",
  "created_at": "2026-11-03T09:41:27.000Z",
  "data": {
    "object": {
      "id": "doc_3y9Pf34qY6Nb3wWD25RQ4F",
      "object": "document",
      "status": "sent",
      "title": "Service agreement - Northwind",
      "recipients": [ { "id": "rcp_5ZR3qa7yEeeby3abP3E2Zs", "object": "recipient", "status": "signed", "...": "..." } ],
      "metadata": { "crm_deal_id": "D-10442" },
      "...": "the full document object"
    },
    "recipient_id": "rcp_5ZR3qa7yEeeby3abP3E2Zs"
  }
}