---
title: "List an e-signature envelope's timeline (business)"
method: GET
path: "/compliance/esign/envelopes/{id}/events"
tags: ["compliance", "esign", "business", "customer-session"]
---

# List an e-signature envelope's timeline (business)

`GET /compliance/esign/envelopes/{id}/events`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/compliance/esign/envelopes/{id}/events`
- Auth: none declared

Returns the timeline of one of the caller's business's envelopes, oldest first, with the acting member's name resolved at read time: at most the 500 most recent stored entries, less copies from another source of an occurrence recorded within two minutes of each other; a paired viewed entry may show the copy's earlier time. When the timeline is whole, total_count equals the page; when older entries were left out, total_count is the number of stored entries and exceeds the page. Another business's envelope and a nonexistent id answer the same 404 (document_not_found).

## Path parameters

- `id` string, required

## Response `200`

OK

- PageEsignEnvelopeEventView
  - `data` EsignEnvelopeEventView[], nullable, required
    - `actor_display_name` string
    - `kind` 'envelope_created' | 'authority_attested' | 'step_up_verified' | 'environment_proven' | 'sent' | 'session_issued' | 'viewed' | 'signed' | 'completed' | 'declined' | 'expired' | 'voided' | 'reassigned' | 'delivery_failed' | 'send_failed' | 'auth_failed' | 'archive_started' | 'artifact_stored' | 'attestation_generated' | 'executed' | 'acceptance_recorded' | 'email_sent' | 'email_failed' | 'failed' | 'repair_started' | 'repair_voided' | 'assurance_uplift' | 'void_requested' | 'provider_not_ready' | 'provider_ready', required
    - `occurred_ts` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `total_count` integer, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `default`: Error response.

## Changes

- **2026-10-29** `e003c8a67b62`: 4 info
  - added the optional property `error/authorization` to the response with the `401` status
  - added the optional property `error/authorization` to the response with the `403` status
  - added the optional property `error/authorization` to the response with the `404` status
  - added the optional property `error/authorization` to the response with the `default` status
- **2026-10-16** `d8ab48e744d6`: 1 info
  - api tag `customer-session` added
- **2026-10-07** `fe94c97bbbe7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/compliance/esign/envelopes/:id/events/get.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/772c80d83658?raw)