> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atlaswork.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Envelope event history

> 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.



## OpenAPI

````yaml /openapi.json get /api/v1/envelopes/{id}/events
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/v1/envelopes/{id}/events:
    get:
      tags:
        - envelopes
      summary: Envelope event history
      description: >-
        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.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Envelope id
          required: true
          description: Envelope id
          name: id
          in: path
      responses:
        '200':
          description: All events, ordered by seq
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        envelopeId:
                          type: string
                        organizationId:
                          type: string
                        seq:
                          type: integer
                        actorType:
                          type: string
                          enum:
                            - sender
                            - signer
                            - agent
                            - system
                            - operator
                        actorId:
                          type: string
                          nullable: true
                        action:
                          type: string
                          enum:
                            - 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.details_corrected
                            - participant.fields_auto_resolved
                            - participant.signed
                            - participant.declined
                            - participant.reminder_sent
                            - participant.email_updated
                            - participant.forward_copy_requested
                            - envelope.artifacts_generated
                            - envelope.completed
                            - envelope.voided
                            - envelope.expired
                            - extraction.requested
                            - extraction.completed
                            - extraction.failed
                            - notification.sent
                            - notification.failed
                            - notification.delivered
                            - notification.opened
                            - notification.bounced
                            - notification.complained
                        payload:
                          nullable: true
                        occurredAt:
                          type: string
                          format: date-time
                        ipAddress:
                          type: string
                          nullable: true
                        userAgent:
                          type: string
                          nullable: true
                        prevHash:
                          type: string
                        hash:
                          type: string
                      required:
                        - id
                        - envelopeId
                        - organizationId
                        - seq
                        - actorType
                        - actorId
                        - action
                        - occurredAt
                        - prevHash
                        - hash
                required:
                  - items
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '404':
          description: Envelope not found in this organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
      security:
        - apiKey: []
        - oauthJwt: []
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Organization API key (format `atlas_sk_...`), passed as a bearer token
        or the x-api-key header. Created and revoked in the dashboard (Better
        Auth api-key plugin); shown in full only once and stored hashed.
    oauthJwt:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Better Auth OAuth resource access token. The token audience must match
        the Atlas MCP resource and include the scope required by the route.

````