---
title: "Get audit trail"
method: GET
path: "/esign/sessions/{sessionId}/audit"
tags: ["E-Signatures"]
---

# Get audit trail

`GET /esign/sessions/{sessionId}/audit`

Returns the complete chronological audit trail for a signing session, including all events like invitations, views, signatures, and completions.

## Path parameters

- `sessionId` string, required

## Response `200`

Audit trail

- object
  - `sessionId` string
  - `events` AuditEvent[]
    - `id` string
    - `eventType` 'session_created' | 'session_completed' | 'session_expired' | 'session_cancelled' | 'invite_sent' | 'invite_resent' | 'link_opened' | 'document_viewed' | 'consent_given' | 'signer_completed' | 'signer_declined' | 'field_signed' | 'field_cleared' | 'session_voided' | 'reminder_sent' — Type of audit event.
    - `actorType` 'system' | 'signer' | 'admin'
    - `actorEmail` string
    - `actorSignerIndex` integer, nullable
    - `fieldId` string, nullable
    - `fieldType` string, nullable
    - `metadata` object
    - `ipAddress` string
    - `userAgent` string
    - `timestamp` string, date-time

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.dev/docsautomator/apis/docsautomator-api.md) · [All operations](https://skmtc.dev/docsautomator/apis/docsautomator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docsautomator/docsautomator-api/revisions/3ec829ff5817/schema)
