## List the sales documents of an opportunity (tenant:crm:read)

`GET /api/crm/v1/opportunities/{id}/documents`

Module: CRM · operationId: `listOpportunityDocuments` · Tag: Opportunities · Auth: access token (`Authorization: Bearer <accessToken>`)

The trade documents (offers, orders and the documents made from them) that name the opportunity
(`opportunityId` in trade), as the CRM keeps them from trade's event feed – newest change first, every
revision on its own. A deleted document disappears. The CRM reacts to them: a new offer or order is a
`SYSTEM` activity of the opportunity; an offer that becomes `ACCEPTED` or a new order moves an open
opportunity to the tenant's first won stage (`crm.opportunity.won`); an offer that becomes `REJECTED`,
`EXPIRED` or `REVOKED` is only noted (a person decides whether the opportunity is lost). Read the
documents themselves through the trade API (`transactionId`).

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes | Record ID (UUID). |

### Responses

- **200** The documents (all of them; no paging). (`application/json`)
- **401** Missing, invalid or expired token (no body).
- **403** The token lacks the permission (`insufficient permissions`) or has no active tenant.
 (`application/json`)
- **404** The record does not exist in the token's tenant. (`application/json`)
- **500** Unexpected error; details are only logged. (`application/json`)

Fields of the 200 answer:

- `items` (array of OpportunityDocument, required): Documents of the opportunity.
  - `createdAt` (string (date-time), required): When the CRM first saw the document.
  - `netTotal` (number (double), required): Net total of the document.
  - `number` (string, required): Document number in trade.
  - `opportunityId` (string (uuid), required): The opportunity the document names.
  - `status` (string, required): Status in trade, e.g. `DRAFT`, `SENT`, `ACCEPTED`, `REJECTED`, `EXPIRED`, `REVOKED`, `CONFIRMED`.
  - `transactionId` (string (uuid), required): Id of the document in trade.
  - `type` (string, required): Trade document type, e.g. `OFFER`, `ORDER`, `DELIVERY_NOTE`, `INVOICE`.
  - `updatedAt` (string (date-time), required): Last change the CRM saw.
  - `version` (integer, required): Revision of the document (each revision is its own document).
  - `sourceTransactionId` (string (uuid)): The document this one was made from (the offer of an order). Omitted when not set.
- `total` (integer, required): Number of documents.

Example 200 answer:

```json
{
  "items": [
    {
      "createdAt": "2026-11-06T10:30:00Z",
      "netTotal": 18400,
      "number": "AN-2026-0012",
      "opportunityId": "7d9f1b3d-5e7a-4c9b-8f1d-5c7e9a1b3d5f",
      "status": "SENT",
      "transactionId": "2b4d6f8b-0c2e-4a4c-8e6a-0c2e4a6c8e0a",
      "type": "OFFER",
      "updatedAt": "2026-11-12T16:40:00Z",
      "version": 2
    }
  ],
  "total": 1
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/crm/v1/opportunities/3f2b8c1e-6d4a-4f7b-9a2e-1c5d7e9f0a12/documents' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
