---
title: "List the business's e-signature envelopes (business)"
method: GET
path: "/compliance/esign/envelopes"
tags: ["compliance", "esign", "business", "customer-session"]
---

# List the business's e-signature envelopes (business)

`GET /compliance/esign/envelopes`

## 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`
- Auth: none declared

Returns the caller's business's e-signature envelopes, newest first. No signing URLs, emails or vendor identifiers.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- PageEsignEnvelopeView
  - `data` EsignEnvelopeView[], nullable, required
    - `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
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `total_count` integer, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `default`: Error response.

## Changes

- **2026-10-29** `e003c8a67b62`: 4 info
  - added the optional property `error/authorization` to the response with the `400` status
  - 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 `default` status
- **2026-10-22** `9c05d53541bb`: 1 warning, 1 info
  - added the new `custody_contract` enum value to the `data/items/purpose` response property for the response status `200`
  - added the optional property `data/items/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 `data/items/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/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/772c80d83658?raw)