finov.ioDocumentationHome

List invoice branding themes

API Documentation / Resources / Accounts and settings

Invoice settings showing payment terms and available invoice branding sets
Open a branding set to review its layout, logo, contact details, and document copy.

List invoice branding themes

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoice-branding-themes

Required OAuth scope: accounting:read

Lists branding themes available when creating customer documents.

At most one active theme is expected to have default=true. Clients may omit a branding-theme identifier to allow Finovio to select that default. Themes are managed in the Finovio application and are read-only in v1.

Parameters

Name In Required Type Description
tenant_id path Yes string (uuid) UUID of the authorized company group.
subsidiary_id path Yes string (uuid) UUID of the subsidiary whose books contain the bank account.
active query No boolean
page query No integer
per_page query No integer

Request

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoice-branding-themes HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}

Responses

Status Description
200 A page of invoice branding themes.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks the required scope or granted accounting context.
422 One or more supplied values failed validation.

200 example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": [
    {
      "id": "57de3fc5-e0f7-49bc-bcba-16f756dcf61a",
      "name": "Aster Ridge standard",
      "default": true,
      "active": true,
      "updated_at": "2026-08-10T08:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 30,
    "last_page": 1,
    "total": 1
  }
}