List fiscal calendars

Operation ID: fiscalCalendars

Group: Accounting › Fiscal Calendars

Open in the interactive reference

GET /accounting/fiscal-calendars

Read-only: Reads and returns; changes nothing.

Lists fiscal calendars. To read a calendar's fiscal years and assigned legal entities, use GET accounting/fiscal-calendars/:id.

Parameters

Name In Type Required Description
Api-Version header string · v1 yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.

Query surface

Response

200 Success

Under data, an array of fiscalCalendarsRow:

Field Type Required Filter Sort Description
id string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes The unique identifier for the fiscal calendar.
calendarName string no no yes The name of the fiscal calendar, unique within the tenant.
description string | null no no no A description of the fiscal calendar. Absent when none has been set.
periodFormat string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes How the fiscal calendar divides a fiscal year into periods. Possible values: 'calendarMonths' (twelve monthly periods), '4-4-5', '4-5-4', '5-4-4' (retail quarters of thirteen weeks, split into periods of that many weeks).
status string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes The lifecycle status of the fiscal calendar. Possible values: 'new', 'active', 'deactivated'. Absent when none has been set.
fiscalYearsCount number | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The number of distinct fiscal years on this calendar. Absent until the first fiscal year exists.
anchorDate date | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The anchor reference date, set only for retail calendars (a '4-4-5', '4-5-4' or '5-4-4' periodFormat). It is the last day of the month before the first period starts. Format YYYY-MM-DD. Absent on a calendarMonths calendar.
lastModifiedDate date-time no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The date and time the fiscal calendar last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. 
{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "calendarName": "<calendarName>",
      "description": "<description>",
      "periodFormat": "<periodFormat>",
      "status": "<status>",
      "fiscalYearsCount": 0,
      "anchorDate": "2026-01-15",
      "lastModifiedDate": "2026-01-15T09:30:00.000Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses