Download invoice PDF

GET

/v1/invoices/{id}/pdf

Returns a booked invoice or credit note as the PDF the customer gets by email, so you can send it yourself. Numina stores the PDF when the invoice is booked, so every download is the same file. Drafts have no PDF here, because they have no invoice number yet.

Requires one ofinvoices:read read:ledger

Path parameters

idstring (uuid)Required
Invoice ID

Errors

401Invalid or missing authentication
403Missing scope, or the company is archived
404The resource does not exist in this company
409The invoice is a draft or an offer
429Rate limit exceeded
500Internal Server Error

Every error has the same shape. See Errors.

cURL

curl https://api.numina.app/v1/invoices/550e8400-e29b-41d4-a716-446655440000/pdf \
  -H "Authorization: Bearer numi_YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.numina.app/v1/invoices/550e8400-e29b-41d4-a716-446655440000/pdf", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.NUMINA_API_KEY}`,
  },
});

const data = await response.json();

Python

import os

import requests

response = requests.get(
    "https://api.numina.app/v1/invoices/550e8400-e29b-41d4-a716-446655440000/pdf",
    headers={
        "Authorization": f"Bearer {os.environ['NUMINA_API_KEY']}",
    },
)
data = response.json()