---
title: "Get signing request audit trail"
method: GET
path: "/signing-requests/{id}/audit"
tags: ["Signing Requests"]
---

# Get signing request audit trail

`GET /signing-requests/{id}/audit`

Retrieve the complete audit trail for a signing request, combining admin actions (created, edited, sent, cancelled) and signer actions (viewed, signed, declined, downloaded). Events are sorted chronologically.

## Path parameters

- `id` string, uuid, required

## Response `200`

Audit trail retrieved successfully

- AuditTrailListResponse — List of audit trail entries
  - `results` object[], required
    - `id` string, uuid
    - `timestamp` string, date-time
    - `source` 'admin' | 'signer' — Whether the event was triggered by an admin/API or a signer
    - `event` string — Event type identifier
    - `description` string — Human-readable event description
    - `actor` object, nullable — Who performed the action (signer name/email or admin/API key)
    - `ip_address` string, nullable — IP address of the signer (signer events only)
    - `details` object, nullable — Additional event-specific metadata

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist
- `429` — Too Many Requests - Rate limit exceeded

---

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