Sign in

v1

latestOpenAPI 3.0.12026-07-144840447.2 KB
Fiscal years

Create a fiscal year

Create a fiscal year. Fiscal years must be consecutive and cannot overlap.

ℹ️ This endpoint requires the following scope: fiscal_years:all

post/api/external/firm/v1/companies/{company_id}/fiscal_years

Path parameters

company_idinteger required

Existing company identifier (id)

Request body

startstring date required

The date at which the fiscal year starts (ISO 8601). Fiscal years must be consecutive and cannot overlap.

finishstring date required

The date at which the fiscal year ends (ISO 8601)

Example request

{
  "start": "2026-01-01",
  "finish": "2026-12-31"
}

Response

Returns the created fiscal year

idinteger required
startstring date required

The date at which the fiscal year starts.

finishstring date required

The date at which the fiscal year ends.

status'open' | 'reopen' | 'closed' | 'frozen' required

The status of the fiscal year.

Example response

{
  "start": "2023-08-30",
  "finish": "2022-12-31",
  "status": "open"
}