finov.ioDocumentationHome

List or create payment terms

API Documentation / Resources / Accounts and settings

New payment term dialog with name code calculation point offsets and status fields
Build a due-date rule from a calculation point and optional month or day offsets.

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