---
title: "Read one e-signature envelope (business)"
method: GET
path: "/compliance/esign/envelopes/{id}"
tags: ["compliance", "esign", "business", "customer-session"]
---

# Read one e-signature envelope (business)

`GET /compliance/esign/envelopes/{id}`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/compliance/esign/envelopes/{id}`
- Auth: none declared

Returns one of the caller's business's envelopes, reconciling it with the provider first when it is due. Verification digests are present once executed. Another business's envelope and a nonexistent id answer the same 404 (document_not_found).

## Path parameters

- `id` string, required

## Response `200`

OK

- EsignEnvelopeView
  - `artifacts` EsignEnvelopeArtifactsView, required
    - `executed_document` boolean, required
    - `provider_certificate` boolean, required
  - `contract_type` 'custody_sa' | 'trade_sa': A custody contract: custody_sa (the custodial services agreement) or trade_sa (the electronic trading agreement). On an envelope it names the contract a custody_contract envelope signs, and is absent when purpose is msa. On a create it is required when purpose is custody_contract and must be absent when purpose is msa.
  - `created_ts` string, date-time, required
  - `document` EsignEnvelopeDocumentView, required
    - `associated_entity` string, required
    - `customer_legal_name` string
    - `document_id` string, required
    - `file_name` string, required
    - `version` string, required
  - `executed_ts` string, date-time, nullable
  - `id` string, required
  - `provider` string, required
  - `purpose` 'msa' | 'custody_contract', required
  - `signer` EsignEnvelopeSignerView, required
    - `display_name` string, required
    - `individual_id` string, nullable
    - `signed_ts` string, date-time, nullable
    - `status` 'pending' | 'viewed' | 'signed' | 'declined' | 'reassigned', required
    - `title` string, required
    - `viewed_ts` string, date-time, nullable
  - `status` 'preparing' | 'awaiting_signatures' | 'partially_signed' | 'archiving' | 'needs_repair' | 'executed' | 'declined' | 'expired' | 'voided' | 'failed', required: Lifecycle of the envelope. preparing: being sent to the provider. awaiting_signatures: out for signature. archiving: signed; the executed copy and evidence are being stored. needs_repair: signed or sent, waiting on an operator; the signature stands. executed: signed and durably stored; the agreement it signs is accepted. declined/expired/voided/failed: ended without a signature; start a new envelope.
  - `verification` EsignEnvelopeVerificationView
    - `certificate_sha256` string, nullable
    - `executed_sha256` string, required
    - `source_sha256` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `default`: Error response.

## Changes

- **2026-10-29** `e003c8a67b62`: 4 info
  - added the optional property `error/authorization` to the response with the `401` status
  - added the optional property `error/authorization` to the response with the `403` status
  - added the optional property `error/authorization` to the response with the `404` status
  - added the optional property `error/authorization` to the response with the `default` status
- **2026-10-22** `9c05d53541bb`: 1 warning, 1 info
  - added the new `custody_contract` enum value to the `purpose` response property for the response status `200`
  - added the optional property `contract_type` to the response with the `200` status
- **2026-10-16** `d8ab48e744d6`: 1 info
  - api tag `customer-session` added
- **2026-10-14** `e8862dc94b6d`: 1 info
  - added the optional property `document/customer_legal_name` to the response with the `200` status
- **2026-10-07** `fe94c97bbbe7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/compliance/esign/envelopes/:id/get.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/6f5456d6453c?raw)