Download a public invoice as a PDF

GET

/public-invoice-pdfs/{code}

Fetches an invoice by its public invoice_number and renders it as a downloadable PDF, base64-encoded in the response body. This endpoint is intentionally unauthenticated — it is the link shared directly with the invoice recipient (for example, embedded in an email or payment page), so no Authorization header is required. Only invoices in an issued or sent status are publicly visible; draft, void, and cancelled invoices always return a 404, whether or not the invoice_number exists, so as not to leak invoice existence or lifecycle state to unauthenticated callers. The first time this endpoint is called for a given invoice, the invoice's viewed_at timestamp is set as a side effect; subsequent calls do not change it.

Request

Path Params

Responses

🟢200

application/json

Invoice was found, publicly visible, and the PDF was rendered successfully.

Bodyapplication/json

🟠400

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/public-invoice-pdfs/INV-01HQZR2BKPFQ8MXJVT3G7LWND'

Response Example

200 - Success

{
    "message": "Invoice PDF generated successfully",
    "status": "success",
    "data": {
        "filename": "invoice-INV-01HQZR2BKPFQ8MXJVT3G7LWND.pdf",
        "content_type": "application/pdf",
        "base64": "JVBERi0xLjMKJcTl8uXrp..."
    }
}

Modified at 2026-09-30 00:29:45

Retrieve an invoice as a PDF

Retrieve a public invoice by invoice number