You can fetch the audit events recorded for a signing session:
GET /sign/sessions/{session_id}/auditRecords are returned oldest first. Use the list to show a simple activity flow, or persist it in your system if you need your own audit trail. See List audit records for a signing session.
Each record includes id, actor, actor_id, type, timestamp, and client. Other fields depend on the event type.
{
"data": [
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88401",
"actor": "integrator",
"actor_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88001",
"type": "session.created",
"timestamp": "2026-09-24T11:16:15.897Z",
"client": {
"ip": "203.0.113.10",
"user_agent": "PostmanRuntime/7.56.1"
}
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88402",
"actor": "integrator",
"actor_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88001",
"type": "participant.added",
"timestamp": "2026-09-24T11:16:15.903Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"client": {
"ip": "203.0.113.10",
"user_agent": "PostmanRuntime/7.56.1"
}
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88403",
"actor": "integrator",
"actor_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88001",
"type": "participant.added",
"timestamp": "2026-09-24T11:16:15.909Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88212",
"client": {
"ip": "203.0.113.10",
"user_agent": "PostmanRuntime/7.56.1"
}
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88404",
"actor": "system",
"actor_id": null,
"type": "participant.invitation.created",
"timestamp": "2026-09-24T11:16:15.904Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"invitation_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88311",
"delivery": {
"type": "manual",
"target": null
},
"client": null
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88405",
"actor": "system",
"actor_id": null,
"type": "participant.invitation.created",
"timestamp": "2026-09-24T11:16:15.908Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"invitation_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88312",
"delivery": {
"type": "email",
"target": "john.doe@example.org"
},
"client": null
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88406",
"actor": "system",
"actor_id": null,
"type": "participant.invitation.created",
"timestamp": "2026-09-24T11:16:15.909Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88212",
"invitation_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88321",
"delivery": {
"type": "manual",
"target": null
},
"client": null
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88407",
"actor": "system",
"actor_id": null,
"type": "participant.invitation.created",
"timestamp": "2026-09-24T11:16:15.911Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88212",
"invitation_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88322",
"delivery": {
"type": "sms",
"target": "+358401234567",
"message": "Please sign by Friday."
},
"client": null
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88408",
"actor": "integrator",
"actor_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88001",
"type": "session.started",
"timestamp": "2026-09-24T11:16:19.647Z",
"client": {
"ip": "203.0.113.10",
"user_agent": "PostmanRuntime/7.56.1"
}
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f88409",
"actor": "system",
"actor_id": null,
"type": "participant.invitation.sent",
"timestamp": "2026-09-24T11:16:19.974Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"invitation_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88312",
"delivery": {
"type": "email",
"target": "john.doe@example.org"
},
"client": null
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f8840a",
"actor": "participant",
"actor_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"type": "participant.invitation.opened",
"timestamp": "2026-09-24T11:16:57.698Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"invitation_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88312",
"delivery": {
"type": "email",
"target": "john.doe@example.org"
},
"client": {
"ip": "203.0.113.20",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36"
}
},
{
"id": "0196ae5b-2e9d-729f-aba5-fa4db6f8840b",
"actor": "participant",
"actor_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"type": "participant.signing.identity-proven",
"timestamp": "2026-09-24T11:17:05.000Z",
"participant_id": "0196ae5b-2e9d-729f-aba5-fa4db6f88211",
"identity_proof": {
"auth_type": "eid",
"auth_channel": "fi_nordea",
"identity": {
"name": "John Doe",
"date_of_birth": "1990-01-15"
},
"prover": {
"name": "Telia Tunnistus",
"proof_id": "bank-session-42"
},
"proven_at": "2026-09-24T11:17:05.000Z"
},
"client": {
"ip": "203.0.113.20",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36"
}
}
],
"meta": {
"status": {
"code": 200,
"text": "OK"
}
}
}| Type | Meaning |
|---|---|
session.created | The session is created. |
session.started | The session is started. |
session.completed | Every participant has signed. |
session.cancelled | The session is cancelled. |
session.discarded | The session is discarded. |
session.expired | The session expired before it was completed. |
participant.added | A participant is added. |
participant.removed | A participant is removed. |
participant.declined | A participant declines to sign. |
participant.reinstated | A declined participant is brought back to pending. |
participant.excused | A participant is excused from signing. |
participant.invitation.created | An invitation is created. |
participant.invitation.sent | An invitation is sent by email or SMS. |
participant.invitation.opened | An invitation is opened. |
participant.invitation.revoked | An invitation is revoked. |
participant.signing.identity-proven | The participant's identity is proven. |
participant.signing.completed | A participant signs. |