List accounting periods

Operation ID: accountingPeriods

Group: Accounting › Accounting Periods

Open in the interactive reference

GET /accounting/accounting-periods

Read-only: Reads and returns; changes nothing.

Lists accounting periods. Each item is one period for one legal entity and one accounting book.

To read an item with its period-close checklist, use GET accounting/accounting-periods/:id.

Parameters

Query surface

• id — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• accountingPeriodId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• entityId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• bookId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• fiscalCalendarId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• periodName — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• fiscalYear — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• fiscalQuarter — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• startDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• endDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• status — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• reopenedByCascade — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• durationDays — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• hasTransactions — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• postable — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• lastModifiedDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• Orderable: id, periodName, fiscalYear, fiscalQuarter, startDate, endDate, status, durationDays, postable, lastModifiedDate
• Selectable: id, accountingPeriodId, entityId, entityName, bookId, bookName, fiscalCalendarId, fiscalCalendarName, periodName, fiscalYear, fiscalQuarter, startDate, endDate, status, reopeningReason, reopenedByCascade, durationDays, hasTransactions, postable, postableReason, lastModifiedDate
• page[size] — Page size
• page[cursor] — Opaque continuation cursor

Response

200 Success

Under data, an array of accountingPeriodsRow:

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "accountingPeriodId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "entityName": "<entityName>",
      "bookId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bookName": "<bookName>",
      "fiscalCalendarId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fiscalCalendarName": "<fiscalCalendarName>",
      "periodName": "<periodName>",
      "fiscalYear": "<fiscalYear>",
      "fiscalQuarter": "<fiscalQuarter>",
      "startDate": "2026-01-15",
      "endDate": "2026-01-15",
      "status": "<status>",
      "reopeningReason": "<reopeningReason>",
      "reopenedByCascade": true,
      "durationDays": 0,
      "hasTransactions": true,
      "postable": true,
      "postableReason": "<postableReason>",
      "lastModifiedDate": "2026-01-15T09:30:00.000Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses

• 400 — Invalid request or business failure
• 401 — The request carries no valid access token.
• 403 — Not authorized
• 404 — Not found
• 429 — Too many requests from this client address. The response has no body and no Retry-After header.
• 500 — Internal server error