# Order Status & Document Access API

> Retrieve the generated e-Stamp certificate/document once an order completes. Endpoint: `GET https://api-b2b.stampmitra.in/v1/orders/:id/documents`.

API fee: ₹5 per successful call, pay-as-you-go (lower on Growth and Scale). State procurement fee and stamp duty are quoted per order. Sandbox keys are free. Prices exclude 18% GST.

- HTML docs: https://developer.stampmitra.in/docs/estamp/estamp-documents
- Product page: https://developer.stampmitra.in/products/estamp-documents
- Pricing: https://developer.stampmitra.in/pricing
- Authentication: https://developer.stampmitra.in/docs/auth

## List documents for an order

`GET https://api-b2b.stampmitra.in/v1/orders/:id/documents`

Required scope: `documents.read`

List generated documents (e.g. the e-Stamp certificate PDF) for a completed order.

### Parameters

- `Authorization` (header, required): Bearer <api-key> (e.g. sk_test_... in sandbox, sk_live_... in production). The x-api-key header is also accepted.

## Get a document download URL

`GET https://api-b2b.stampmitra.in/v1/orders/:id/documents/:documentId/download`

Required scope: `documents.read`

Get a (typically short-lived, signed) URL to download a specific document.

### Parameters

- `Authorization` (header, required): Bearer <api-key> (e.g. sk_test_... in sandbox, sk_live_... in production). The x-api-key header is also accepted.

### Response example

```json
{
  "downloadUrl": "https://files.stampmitra.in/signed/doc_00789.pdf?token=abc123",
  "expiresAt": "2026-10-15T09:56:07.000Z"
}
```