Référence de l'API

Événements

Ce qui est arrivé à vos documents dans les 90 derniers jours. Les mêmes événements que livrent les webhooks.

Points de terminaison · 2

GET Lister les événements
GET Récupérer un événement

L'objet

Champ	Saisir	Description
`id`	string	Identifiant unique, commençant par evt_.
`object`	string	Toujours "event".
`type`	string	Voyez Événements de webhook.
`created_at`	timestamp
`data`	object	data.object est le document au moment de l'événement; les événements de destinataire ajoutent recipient_id.

GET/events

Lister les événements

Les plus récents d'abord, 90 derniers jours.

Paramètre	Saisir		Description
`limit`	integer	facultatif	Nombre d'objets à renvoyer, de 1 à 100. Par défaut 20.
`starting_after`	string	facultatif	Le next_cursor de la page précédente. Omettez-le pour la première page.
`type`	string	facultatif	Un type d'événement.
`document_id`	string	facultatif	Les événements d'un document.

Requête

bash

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

Réponse

json

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

GET/events/{id}

Récupérer un événement

Requête

bash

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

Réponse

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"
  }
}