---
title: "Get a short-lived download URL for the document file"
method: POST
path: "/receivables/{id}/documents/{document_id}/download"
tags: ["Receivables"]
---

# Get a short-lived download URL for the document file

`POST /receivables/{id}/documents/{document_id}/download`

## Request

- Base URL: `https://core.sivo.com`
- URL: `https://core.sivo.com/receivables/{id}/documents/{document_id}/download`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://dashboard.sivo.com/oauth/authorize`
    - Client credentials
    - Token URL: `https://core.sivo.com/oauth/token`
- TypeScript: <https://skmtc.dev/sivo/apis/sivo-advance-api/docs/receivables/:id/documents/:document_id/download/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: An object ID assigned and owned by the originator
- `document_id` string, required: An object ID assigned and owned by the originator

## Headers

- `Idempotency-Key` string: A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 256 bytes. See [Idempotent Requests](/docs/idempotent-requests).

## Response `200`

Successful operation

- object
  - `file_name` string, required: Suggested file name for the downloaded document
  - `url` string, uri, required: Short-lived URL to download the document file
  - `expires_at` string, date-time, required: Expiry of the download URL

## Changes

- **2026-11-03** `4bbab9699612`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/receivables/:id/documents/:document_id/download/post.md)

---

[API](https://skmtc.dev/sivo/apis/sivo-advance-api.md) - [All operations](https://skmtc.dev/sivo/apis/sivo-advance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sivo/apis/sivo-advance-api/revisions/4bbab9699612?raw)