---
title: "Download one document of a signing request"
method: GET
path: "/signing-requests/{id}/documents/{document_id}/download"
tags: ["Signing Requests"]
---

# Download one document of a signing request

`GET /signing-requests/{id}/documents/{document_id}/download`

## Request

- Base URL: `https://api.firma.dev/functions/v1/signing-request-api`
- URL: `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/documents/{document_id}/download`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/firma/apis/firma-partner-api/docs/signing-requests/:id/documents/:document_id/download/get.ts> (a function with typed inputs; its response is checked against the schema)

`type=original` (the default): a signed URL to the document as uploaded (`404 DOCUMENT_ORIGINAL_NOT_AVAILABLE` when it is no longer stored). `type=document`: a signed URL to the individually sealed document, available once the certificate is bound (`404 DOCUMENT_SIGNED_NOT_AVAILABLE` before). The URL is valid for 1 hour.

**Available to every company.** This operation is part of the multi-document contract (API 01.39.00). For a signing request or template the API key cannot see, it answers `404` with code `NOT_FOUND` ("Endpoint not found"), exactly as an unknown endpoint does. While multi-document editing is suspended, this operation remains available for parents on the multi-document read-only path; parents on the single-document path answer `404 NOT_FOUND`.

## Path parameters

- `id` string, uuid, required
- `document_id` string, uuid, required

## Query parameters

- `type` 'original' | 'document'

## Response `200`

A signed download URL

- object
  - `download_url` string, uri, required
  - `expires_at` string, date-time, required

## Other responses

- `400`: Bad request: `VALIDATION_ERROR`
- `401`: Unauthorized - Invalid or missing API key
- `404`: NOT_FOUND: the parent uses the single-document path while multi-document editing is suspended, or the signing request is absent, deleted or not visible to this API key ("Endpoint not found"). DOCUMENT_NOT_FOUND: no document with this id in this signing request. DOCUMENT_SIGNED_NOT_AVAILABLE / DOCUMENT_ORIGINAL_NOT_AVAILABLE: see the operation description.
- `409`: Conflict: `DOCUMENT_SET_BUSY`, `DOCUMENT_SET_DISPATCH_STALE`, `DOCUMENT_SET_INCONSISTENT`
- `500`: Internal error (code `INTERNAL`)

## Changes

- **2026-10-10** `bfc2b19c9c7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/firma/apis/firma-partner-api/changes/signing-requests/:id/documents/:document_id/download/get.md)

---

[API](https://skmtc.dev/firma/apis/firma-partner-api.md) - [All operations](https://skmtc.dev/firma/apis/firma-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/firma/apis/firma-partner-api/revisions/7326991ebc59?raw)