---
title: "Extract completed contract data"
method: GET
path: "/api/v1/envelopes/{id}/extract"
tags: ["envelopes"]
---

# Extract completed contract data

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

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.

## Path parameters

- `id` string, required — Envelope id

## Response `200`

Extraction status or completed structured contract data

- union
  - object
    - `status` 'not_extracted', required
    - `envelopeId` string, required
    - `envelopeStatus` 'draft' | 'detecting' | 'review' | 'in_progress' | 'completed' | 'declined' | 'voided' | 'expired', required
    - `message` string, required
  - object
    - `status` 'extracted', required
    - `envelopeId` string, required
    - `envelopeStatus` 'completed', required
    - `parties` object[], required
      - `name` string, required
      - `email` string, email, required
      - `company` string, nullable, required
      - `role` string, nullable, required
      - `signedAt` string, date-time, nullable, required
    - `dates` object, required
      - `effectiveDate` string, nullable, required
      - `expirationDate` string, nullable, required
      - `sentAt` string, date-time, nullable, required
      - `completedAt` string, date-time, nullable, required
    - `governingLaw` string, nullable, required
    - `fields` object[], required
      - `label` string, required
      - `type` 'signature' | 'initials' | 'date' | 'text' | 'checkbox', required
      - `value` string, required

## Other responses

- `401` — Missing or invalid API key or OAuth access token
- `403` — Credential lacks envelopes:read or extract:read
- `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)