Developers

PUBLIC API v1

List invoice templates and appearance choices

GET /api/v1/companies/{company_pk}/invoices/document-templates/

Return detail-serialized created instance

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

Responses

200 Response fields

application/json

FieldType / accepted valuesDescription
templatesRequiredobject[]Not specified
Nested fields
FieldType / accepted valuesDescription
idRequiredstringNot specified
nameRequiredstringNot specified
premiumRequiredbooleanNot specified
availableRequiredbooleanNot specified
fontRequiredstringNot specified
headingFontRequiredstring | nullNot specified
documentDesignRequiredobjectNot specified
Nested fields
FieldType / accepted valuesDescription
templateRequired"heritage" | "regent" | "meridian" | "horizon" | "atelier" | "epoque" | "sovereign"* `heritage` - heritage * `regent` - regent * `meridian` - meridian * `horizon` - horizon * `atelier` - atelier * `epoque` - epoque * `sovereign` - sovereign
version1* `1` - 1
logoSizeintegerNot specified
textSize"small" | "medium" | "large"* `small` - small * `medium` - medium * `large` - large
spacing"compact" | "standard" | "spacious"* `compact` - compact * `standard` - standard * `spacious` - spacious
tableBorders"none" | "dividers" | "grid"* `none` - none * `dividers` - dividers * `grid` - grid
textSizesRequiredstring[]Not specified
spacingsRequiredstring[]Not specified
tableBordersRequiredstring[]Not specified
logoSizeRequiredobjectNot specified
coloursRequiredobjectNot specified
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.