Developers

PUBLIC API v1

Get an invoice PDF download link

GET /api/v1/companies/{company_pk}/invoices/{public_id}/pdf/

Return a short redirect URL for the invoice PDF (valid for 1 hour).

Permission: read_invoices · Direct link

Company-scoped. Account permissions, plan limits and document state still apply.

Path and query parameters

ParameterLocation / typeDescription
company_pkRequiredpath · string (uuid)Not specified
public_idRequiredpath · string (uuid)Not specified

Responses

200 Response fields

application/json

FieldType / accepted valuesDescription
urlRequiredstring (uri)Temporary download link, valid for one hour. Treat it as sensitive.
401 The API key is invalid, expired or revoked.
403 Missing scope, company mismatch, unsupported operation, or a plan/account restriction.
429 Rate limit exceeded. Wait for the Retry-After header before retrying.

Use the base URL https://api.norman.finance/api/v1. Sign up or log in to Norman to create an API key, then send it as a Bearer token. For an OpenAPI JSON file, contact support.