---
title: "Envelope event history"
method: GET
path: "/api/v1/envelopes/{id}/events"
tags: ["envelopes"]
---

# Envelope event history

`GET /api/v1/envelopes/{id}/events`

Returns the envelope's hash-chained event log ordered by `seq` ascending — the poll surface for lifecycle progress. Envelopes outside the API key's organization yield 404. Note: `participant.fields_auto_resolved` event payloads carry machine-derived field values in plaintext (signer name/email, signing date, sender org) — treat responses from this endpoint per your data-retention policy.

## Path parameters

- `id` string, required — Envelope id

## Response `200`

All events, ordered by seq

- object
  - `items` object[], required
    - `id` string, required
    - `envelopeId` string, required
    - `organizationId` string, required
    - `seq` integer, required
    - `actorType` 'sender' | 'signer' | 'agent' | 'system' | 'operator', required
    - `actorId` string, nullable, required
    - `action` 'envelope.created' | 'envelope.display_name_updated' | 'envelope.participants_updated' | 'envelope.fields_updated' | 'envelope.policy_updated' | 'envelope.sender_updated' | 'detection.started' | 'detection.completed' | 'detection.failed' | 'envelope.send_scheduled' | 'envelope.send_schedule_canceled' | 'envelope.sent' | 'participant.link_issued' | 'participant.link_reissued' | 'participant.viewed' | 'participant.consented' | 'participant.fields_auto_resolved' | 'participant.signed' | 'participant.declined' | 'participant.reminder_sent' | 'envelope.artifacts_generated' | 'envelope.completed' | 'envelope.voided' | 'envelope.expired' | 'extraction.requested' | 'extraction.completed' | 'extraction.failed' | 'notification.sent' | 'notification.failed', required
    - `payload` unknown
    - `occurredAt` string, date-time, required
    - `ipAddress` string, nullable
    - `userAgent` string, nullable
    - `prevHash` string, required
    - `hash` string, required

## Other responses

- `401` — Missing or invalid API key
- `404` — Envelope not found in this organization

---

[API](https://skmtc.net/atlaswork/apis/atlas-api.md) · [All operations](https://skmtc.net/atlaswork/apis/atlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlaswork/atlas-api/versions/a8a1e7479c90/schema)