List or create payment terms
API Documentation / Resources / Accounts and settings

List payment terms
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/payment-terms
Required OAuth scope: accounting:read
Lists active and archived due-date rules configured for the subsidiary.
| Parameter | Meaning | Default |
|---|---|---|
active |
Filter active or inactive terms | All |
search |
Case-insensitive name search | No search |
sort |
name or updated_at |
name |
order |
asc or desc |
asc |
Results with equal sort values use stable resource order.
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 | |
search |
query | No | string | |
page |
query | No | integer | |
per_page |
query | No | integer | |
sort |
query | No | string: name, updated_at | |
order |
query | No | string: asc, desc |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/payment-terms HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
A page of payment terms. |
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": "109f329b-7172-4de6-b03b-c83f03141510",
"name": "Net 20",
"calculation": "days_after_invoice",
"days": 20,
"day_of_month": null,
"active": true,
"created_at": "2026-08-10T12:00:00Z",
"updated_at": "2026-08-10T12:00:00Z"
}
],
"meta": {
"current_page": 1,
"per_page": 30,
"last_page": 1,
"total": 1
}
}
Create a payment term
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/payment-terms
Required OAuth scope: accounting:write
Creates a reusable invoice due-date rule.
Calculation rules
| Calculation | Due-date behavior | Additional field |
|---|---|---|
days_after_invoice |
Adds days to the invoice date |
day_of_month must be null or omitted |
day_of_following_month |
Moves to the following month and selected day | day_of_month is required |
Calendar-day overflow is clamped to the final valid day of the target month. For example, day 31 becomes 28 or 29 in February.
Names must be unique among unarchived terms in the subsidiary.
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. |
Request
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/payment-terms HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"name": "Net 20",
"calculation": "days_after_invoice",
"days": 20
}
Required body fields: name, calculation, days.
Responses
| Status | Description |
|---|---|
201 |
Payment term created. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
409 |
Request conflicts with uniqueness or current accounting state. |
422 |
One or more supplied values failed validation. |
201 example
HTTP/1.1 201 Created
Content-Type: application/json
{
"data": {
"id": "109f329b-7172-4de6-b03b-c83f03141510",
"name": "Net 20",
"calculation": "days_after_invoice",
"days": 20,
"day_of_month": null,
"active": true,
"created_at": "2026-08-10T12:00:00Z",
"updated_at": "2026-08-10T12:00:00Z"
}
}