Audit Logs

GET `/api/v1/signature_requests/{signature_request_id}/audit_logs`

Récupère la liste chronologique des événements d'une signature request. La réponse est un tableau ordonné par created_at croissant (pas de pagination aujourd'hui).

Types d'événements

Event	Description
`signature_request.created`	Création initiale de la signature request.
`signature_request.identity_declared`	L'expéditeur a confirmé l'identité des signataires.
`signer.notified`	Notification d'invitation envoyée à un signataire.
`signer.otp_sent`	OTP envoyé à un signataire (e-mail ou SMS).
`signer.signed`	Signature individuelle finalisée.
`request.completed`	Tous les signataires ont signé.
`request.completion_notified`	E-mail récapitulatif de complétion envoyé aux signataires.
`request.expired`	Délai de validité dépassé.

Parmi ces événements, seuls cinq déclenchent un webhook (signer.notified, signer.otp_sent, signer.signed, request.completed, request.expired). Les autres sont uniquement consultables via cet endpoint — voir Webhooks.

Exemple

curl https://app.signlift.eu/api/v1/signature_requests/42/audit_logs \
  -H "X-Api-Key: $SIGNLIFT_API_KEY"

Réponse 200

[
  {
    "id": 8124,
    "event_type": "signer.signed",
    "signer_id": 1768,
    "ip": "203.0.113.42",
    "user_agent": "Mozilla/5.0 ...",
    "metadata": {},
    "created_at": "2026-05-17T15:12:43Z"
  }
]

signer_id est null pour les événements qui ne concernent pas un signataire particulier (signature_request.created, request.completed, request.expired, etc.).
metadata est un objet libre qui peut contenir des détails complémentaires selon le type d'événement.