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

# List envelopes

> Cursor-paginated list of the organization's envelopes, ordered by createdAt descending. Pass `nextCursor` from the previous page as `cursor`; `limit` is capped at 100 (default 50). Filter by lifecycle status with `status` (one or more statuses, comma-separated), and by name with `q` (case-insensitive substring of the display name or the original filename).



## OpenAPI

````yaml /openapi.json get /api/v1/envelopes
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/v1/envelopes:
    get:
      tags:
        - envelopes
      summary: List envelopes
      description: >-
        Cursor-paginated list of the organization's envelopes, ordered by
        createdAt descending. Pass `nextCursor` from the previous page as
        `cursor`; `limit` is capped at 100 (default 50). Filter by lifecycle
        status with `status` (one or more statuses, comma-separated), and by
        name with `q` (case-insensitive substring of the display name or the
        original filename).
      parameters:
        - schema:
            type: string
          required: false
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
          required: false
          name: limit
          in: query
        - schema:
            type: string
          required: false
          name: status
          in: query
        - schema:
            type: string
            maxLength: 200
          required: false
          name: q
          in: query
        - schema:
            type: string
            enum:
              - attention
              - waiting
              - drafts
              - completed
              - all
          required: false
          name: view
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          required: false
          name: sender
          in: query
        - schema:
            type: string
          required: false
          name: team
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          required: false
          name: recipient
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          required: false
          name: template
          in: query
        - schema:
            type: string
            format: date-time
          required: false
          name: from
          in: query
        - schema:
            type: string
            format: date-time
          required: false
          name: to
          in: query
        - schema:
            type: string
          required: false
          name: attention
          in: query
        - schema:
            type: string
            enum:
              - created
              - sent
              - completed
              - activity
              - name
              - urgency
          required: false
          name: sort
          in: query
      responses:
        '200':
          description: One page of envelopes
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          type: string
                        teamId:
                          type: string
                        templateId:
                          type: string
                          nullable: true
                        templateContentHash:
                          type: string
                          nullable: true
                        status:
                          type: string
                          enum:
                            - draft
                            - detecting
                            - review
                            - in_progress
                            - completed
                            - declined
                            - voided
                            - expired
                        detectionStatus:
                          type: string
                          enum:
                            - none
                            - running
                            - succeeded
                            - failed
                        version:
                          type: integer
                        originalFilename:
                          type: string
                          nullable: true
                        displayName:
                          type: string
                          nullable: true
                        sourceFormat:
                          type: string
                          nullable: true
                        contentHash:
                          type: string
                          nullable: true
                        sizeBytes:
                          type: number
                          nullable: true
                        deliveryMode:
                          type: string
                        legalFramework:
                          type: string
                          nullable: true
                        consumerDisclosure:
                          type: boolean
                        expiresAt:
                          type: string
                          nullable: true
                          format: date-time
                        scheduledSendAt:
                          type: string
                          nullable: true
                          format: date-time
                        reminderPolicy:
                          nullable: true
                        sentAt:
                          type: string
                          nullable: true
                          format: date-time
                        completedAt:
                          type: string
                          nullable: true
                          format: date-time
                        declinedAt:
                          type: string
                          nullable: true
                          format: date-time
                        voidedAt:
                          type: string
                          nullable: true
                          format: date-time
                        expiredAt:
                          type: string
                          nullable: true
                          format: date-time
                        metadata:
                          nullable: true
                        senderUserId:
                          type: string
                          nullable: true
                        senderName:
                          type: string
                          nullable: true
                        senderEmail:
                          type: string
                          nullable: true
                        detectedParties:
                          nullable: true
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                        teamName:
                          type: string
                        participantCount:
                          type: integer
                          minimum: 0
                        signedCount:
                          type: integer
                          minimum: 0
                        latestActivity:
                          type: object
                          nullable: true
                          properties:
                            label:
                              type: string
                            occurredAt:
                              type: string
                              format: date-time
                          required:
                            - label
                            - occurredAt
                        signers:
                          type: array
                          items:
                            type: object
                            properties:
                              participantId:
                                type: string
                              name:
                                type: string
                              status:
                                type: string
                                enum:
                                  - pending
                                  - signed
                                  - declined
                              lastEventLabel:
                                type: string
                                nullable: true
                              lastEventAt:
                                type: string
                                nullable: true
                                format: date-time
                              lastRemindedAt:
                                type: string
                                nullable: true
                                format: date-time
                              nextReminderAt:
                                type: string
                                nullable: true
                                format: date-time
                            required:
                              - participantId
                              - name
                              - status
                              - lastEventLabel
                              - lastEventAt
                              - lastRemindedAt
                              - nextReminderAt
                        attention:
                          type: array
                          items:
                            type: string
                            enum:
                              - delivery_failed
                              - expires_soon
                              - stalled
                      required:
                        - id
                        - organizationId
                        - teamId
                        - templateId
                        - templateContentHash
                        - status
                        - detectionStatus
                        - version
                        - originalFilename
                        - displayName
                        - sourceFormat
                        - contentHash
                        - sizeBytes
                        - deliveryMode
                        - legalFramework
                        - consumerDisclosure
                        - expiresAt
                        - scheduledSendAt
                        - sentAt
                        - completedAt
                        - declinedAt
                        - voidedAt
                        - expiredAt
                        - createdAt
                        - updatedAt
                        - teamName
                        - participantCount
                        - signedCount
                        - latestActivity
                        - signers
                        - attention
                  nextCursor:
                    type: string
                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
      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.

````