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

# Check signing status

> Returns lightweight participant progress and a human-readable lifecycle summary. Deferred-upload drafts also report whether document bytes have arrived.



## OpenAPI

````yaml /openapi.json get /api/v1/envelopes/{id}/status
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/v1/envelopes/{id}/status:
    get:
      tags:
        - envelopes
      summary: Check signing status
      description: >-
        Returns lightweight participant progress and a human-readable lifecycle
        summary. Deferred-upload drafts also report whether document bytes have
        arrived.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Envelope id
          required: true
          description: Envelope id
          name: id
          in: path
      responses:
        '200':
          description: Current signing progress
          content:
            application/json:
              schema:
                type: object
                properties:
                  envelopeId:
                    type: string
                  status:
                    type: string
                    enum:
                      - draft
                      - detecting
                      - review
                      - in_progress
                      - completed
                      - declined
                      - voided
                      - expired
                  detectionStatus:
                    type: string
                    enum:
                      - none
                      - running
                      - succeeded
                      - failed
                  terminal:
                    type: boolean
                  currentParticipantId:
                    type: string
                    nullable: true
                  participants:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        orderIndex:
                          type: integer
                          minimum: 0
                        name:
                          type: string
                        status:
                          type: string
                          enum:
                            - pending
                            - signed
                            - declined
                        isCurrent:
                          type: boolean
                        signedAt:
                          type: string
                          nullable: true
                          format: date-time
                        declinedAt:
                          type: string
                          nullable: true
                          format: date-time
                        lastViewedAt:
                          type: string
                          nullable: true
                          format: date-time
                      required:
                        - id
                        - orderIndex
                        - name
                        - status
                        - isCurrent
                        - signedAt
                        - declinedAt
                        - lastViewedAt
                  signedCount:
                    type: integer
                    minimum: 0
                  totalParticipants:
                    type: integer
                    minimum: 0
                  lastEventAt:
                    type: string
                    nullable: true
                    format: date-time
                  summary:
                    type: string
                  documentReceived:
                    type: boolean
                required:
                  - envelopeId
                  - status
                  - detectionStatus
                  - terminal
                  - currentParticipantId
                  - participants
                  - signedCount
                  - totalParticipants
                  - lastEventAt
                  - summary
        '401':
          description: Missing or invalid API key or OAuth access token
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  details:
                    type: object
                    additionalProperties:
                      nullable: true
                required:
                  - code
                  - message
        '403':
          description: Credential lacks envelopes:read
          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.

````