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

# Extract completed contract data

> Returns not_extracted until completion. Completed envelopes return deterministic structured parties, lifecycle dates, labeled signed fields, and semantic date/governing-law values when those labels exist.



## OpenAPI

````yaml /openapi.json get /api/v1/envelopes/{id}/extract
openapi: 3.0.0
info:
  title: Atlas API
  version: 0.0.0
servers:
  - url: https://api.atlaswork.ai
security: []
paths:
  /api/v1/envelopes/{id}/extract:
    get:
      tags:
        - envelopes
      summary: Extract completed contract data
      description: >-
        Returns not_extracted until completion. Completed envelopes return
        deterministic structured parties, lifecycle dates, labeled signed
        fields, and semantic date/governing-law values when those labels exist.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Envelope id
          required: true
          description: Envelope id
          name: id
          in: path
      responses:
        '200':
          description: Extraction status or completed structured contract data
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - not_extracted
                      envelopeId:
                        type: string
                      envelopeStatus:
                        type: string
                        enum:
                          - draft
                          - detecting
                          - review
                          - in_progress
                          - completed
                          - declined
                          - voided
                          - expired
                      message:
                        type: string
                    required:
                      - status
                      - envelopeId
                      - envelopeStatus
                      - message
                  - type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - extracted
                      envelopeId:
                        type: string
                      envelopeStatus:
                        type: string
                        enum:
                          - completed
                      parties:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                            email:
                              type: string
                              format: email
                            company:
                              type: string
                              nullable: true
                            role:
                              type: string
                              nullable: true
                            signedAt:
                              type: string
                              nullable: true
                              format: date-time
                          required:
                            - name
                            - email
                            - company
                            - role
                            - signedAt
                      dates:
                        type: object
                        properties:
                          effectiveDate:
                            type: string
                            nullable: true
                          expirationDate:
                            type: string
                            nullable: true
                          sentAt:
                            type: string
                            nullable: true
                            format: date-time
                          completedAt:
                            type: string
                            nullable: true
                            format: date-time
                        required:
                          - effectiveDate
                          - expirationDate
                          - sentAt
                          - completedAt
                      governingLaw:
                        type: string
                        nullable: true
                      fields:
                        type: array
                        items:
                          type: object
                          properties:
                            label:
                              type: string
                            type:
                              type: string
                              enum:
                                - signature
                                - initials
                                - date
                                - text
                                - checkbox
                            value:
                              type: string
                          required:
                            - label
                            - type
                            - value
                    required:
                      - status
                      - envelopeId
                      - envelopeStatus
                      - parties
                      - dates
                      - governingLaw
                      - fields
        '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 or extract: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.

````