---
title: "Download an invoice"
method: GET
path: "/api/v1/billing/invoices/{invoiceId}"
tags: ["billing"]
---

# Download an invoice

`GET /api/v1/billing/invoices/{invoiceId}`

Returns the Stripe-hosted invoice links for one of the account's invoices — Stripe is the source of truth for invoices. Use the `invoiceId` from a deposit or the subscription in GET /api/v1/billing. `invoicePdf` is a direct PDF download; `hostedInvoiceUrl` is Stripe's hosted invoice page. Returns 404 if the invoice doesn't belong to the account.

## Path parameters

- `invoiceId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Stripe-hosted invoice links.

- BillingGetInvoiceResponse200
  - `hostedInvoiceUrl` string, nullable — Stripe-hosted invoice page (has a download button), or null.
  - `invoicePdf` string, nullable — Direct link to the invoice PDF, or null.

## Other responses

- `401` — Missing or invalid API key.
- `404` — No such invoice on this account.

---

[API](https://skmtc.net/getdial/apis/rest-api.md) · [All operations](https://skmtc.net/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdial/rest-api/versions/cfa621230237/schema)