List invoice types
API Documentation / Resources / Connections and subsidiaries

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
}
}