finov.ioDocumentationHome

List invoice types

API Documentation / Resources / Connections and subsidiaries

New customer credit note form with invoice type contact dates and line fields
Choose Credit Note from the Invoices register to prepare a customer credit.

List invoice types

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/invoice-types

Required OAuth scope: accounting:read

Lists stable invoice and credit-note type codes.

Direction Meaning
receivable Customer-facing sales document.
payable Supplier-facing purchase document.

Clients must accept new codes as additive values and use direction when behavior can be generalized.

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.
page query No integer
per_page query No integer

Request

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

Responses

Status Description
200 A page of supported invoice types.
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": [
    {
      "code": "SALES_INVOICE",
      "name": "Sales invoice",
      "direction": "receivable"
    },
    {
      "code": "SUPPLIER_BILL",
      "name": "Supplier bill",
      "direction": "payable"
    },
    {
      "code": "SALES_CREDIT_NOTE",
      "name": "Sales credit note",
      "direction": "receivable"
    },
    {
      "code": "SUPPLIER_CREDIT_NOTE",
      "name": "Supplier credit note",
      "direction": "payable"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 30,
    "last_page": 1,
    "total": 4
  }
}