> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleo-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the invoice PDF link

> GET /v1/payables/{payableId}/invoice-pdf returns a signed download link, valid for 15 minutes, for the invoice PDF Cleo renders from a bill.

```
GET /v1/payables/{payableId}/invoice-pdf
```

**Scope:** `payables:read`

Returns a link to the invoice PDF that Cleo renders from the bill, the same PDF the bill's **Invoice** tab shows in the Cleo web app. It is not a file someone attached. For those, see [Get a file link](https://docs.cleo-pay.com/api-reference/payables/get-file.md).

**payableId** `string` *required*

The bill's `id`.

```bash theme={null}
curl "https://api.stg.cleo-pay.com/v1/payables/b1e2c3d4-5f6a-4b8c-9d0e-1f2a3b4c5d6e/invoice-pdf" \
  --header "Authorization: Bearer $CLEO_API_KEY"
```

## Response

`200` with a signed link, in the same shape as [Get a file link](https://docs.cleo-pay.com/api-reference/payables/get-file.md#response).

**url** `string`

The download link. Anyone who holds it can download the PDF until it expires, so do not log it or share it.

**expiresAt** `string`

When the link stops working, ISO 8601, 15 minutes after it was issued.

```json theme={null}
{
  "url": "https://s3.us-west-2.amazonaws.com/...?X-Amz-Expires=900&X-Amz-Signature=...",
  "expiresAt": "2026-10-29T10:15:00.000Z"
}
```

Every bill you can read has an invoice PDF. If Cleo has not rendered it yet, the first request renders it, which can take a few seconds.

## Errors

| Code | When |
| - | - |
| `not_found` | The bill does not exist or your business cannot see it. |
| `forbidden_scope` | The key lacks `payables:read`, or its member's role cannot view bills. |
| `internal_error` | Cleo could not render the PDF. Try again later, and quote the `requestId` to Cleo support if it keeps failing. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.