---
title: "Check signing status"
method: GET
path: "/api/v1/envelopes/{id}/status"
tags: ["envelopes"]
---

# Check signing status

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

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

## Path parameters

- `id` string, required — Envelope id

## Response `200`

Current signing progress

- object
  - `envelopeId` string, required
  - `status` 'draft' | 'detecting' | 'review' | 'in_progress' | 'completed' | 'declined' | 'voided' | 'expired', required
  - `detectionStatus` 'none' | 'running' | 'succeeded' | 'failed', required
  - `terminal` boolean, required
  - `currentParticipantId` string, nullable, required
  - `participants` object[], required
    - `id` string, required
    - `orderIndex` integer, required
    - `name` string, required
    - `status` 'pending' | 'signed' | 'declined', required
    - `isCurrent` boolean, required
    - `signedAt` string, date-time, nullable, required
    - `declinedAt` string, date-time, nullable, required
    - `lastViewedAt` string, date-time, nullable, required
  - `signedCount` integer, required
  - `totalParticipants` integer, required
  - `lastEventAt` string, date-time, nullable, required
  - `summary` string, required
  - `documentReceived` boolean

## Other responses

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