---
title: "List Fiscal Periods"
method: GET
path: "/accounting/fiscal-periods"
tags: ["Fiscal Periods"]
---

# List Fiscal Periods

`GET /accounting/fiscal-periods`

## Request

- Base URL: `https://unify.apideck.com`
- URL: `https://unify.apideck.com/accounting/fiscal-periods`
- Auth: API key in header `Authorization`

List the fiscal (accounting) periods of the company, with their dates and whether they are open for posting.

## Query parameters

- `raw` boolean
- `cursor` string, nullable
- `limit` integer
- `pass_through` PassThroughQuery
  - `example_downstream_property` string: All passthrough query parameters are passed along to the connector as is (?pass_through[search]=leads becomes ?search=leads)
- `fields` string, nullable

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string
- `x-apideck-company-id` string

## Response `200`

Fiscal Periods

- GetFiscalPeriodsResponse
  - `status_code` integer, required: HTTP Response Status Code
  - `status` string, required: HTTP Response Status
  - `service` string, required: Apideck ID of service provider
  - `resource` string, required: Unified API resource name
  - `operation` string, required: Operation performed
  - `data` FiscalPeriod[], required
    - `id` string: A unique identifier for an object.
    - `name` string, nullable: Name of the fiscal period as shown in the accounting system.
    - `fiscal_year` string, nullable: The calendar year in which the period's fiscal year ends, as four digits (Jul 2025 to Jun 2026 is `2026`). Derived from the fiscal year's end date; the accounting system's own label is in `name`.
    - `period_number` integer, nullable: Position of the period within its fiscal year, starting at 1.
    - `start_date` string, date, nullable: First day of the period (inclusive).
    - `end_date` string, date, nullable: Last day of the period (inclusive).
    - `status` 'open' | 'locked' | 'closed' | 'future', nullable: Whether transactions can be posted into the period. `open`: postings are accepted on at least the last day of the period; a lock date inside the period still rejects earlier dates (see `locked_through`). `locked`: posting is blocked for some users or transaction types only, for example everyone except advisers or administrators. `closed`: posting is blocked for all users until the period or year is reopened. `future`: the accounting system reports the period as not yet opened. Null or absent means the connector does not expose the period's status.
    - `locked_through` string, date, nullable: The last date in the period on which the accounting system's lock date rejects postings for at least some users: the lock date itself, or the period's end date when the lock date is later. Null when no lock date reaches the period or the connector does not expose lock dates.
    - `type` 'period' | 'quarter' | 'year', nullable: Whether this record is a posting period, or a quarter or year that groups posting periods.
    - `is_adjustment` boolean, nullable: Whether the period is an adjustment (closing) period used for year-end entries rather than regular postings.
    - `created_at` string, date-time, nullable: The date and time when the object was created.
    - `updated_at` string, date-time, nullable: The date and time when the object was last updated.
    - `custom_mappings` CustomMappings, nullable: When custom mappings are configured on the resource, the result is included here.
  - `meta` Meta: Response metadata
    - `items_on_page` integer: Number of items returned in the data property of the response
    - `cursors` object: Cursors to navigate to previous or next pages through the API
      - `previous` string, nullable: Cursor to navigate to the previous page of results through the API
      - `current` string, nullable: Cursor to navigate to the current page of results through the API
      - `next` string, nullable: Cursor to navigate to the next page of results through the API
    - `total_count` integer: Number of records available in total for this resource
    - `warnings` object[], nullable: Non-fatal warnings emitted when optional workflow steps failed. Present only when at least one step degraded; the response status remains 200.
      - `type` string: Discriminator for the warning kind.
      - `status_code` integer, nullable: HTTP status code returned by the failed downstream request, when available.
      - `error` string, nullable: Short error description from the downstream provider, when available.
      - `operation` string, nullable: Identifier of the workflow step that failed.
      - `message` string, nullable: Detailed message from the downstream provider, when available.
  - `links` Links: Links to navigate to previous or next pages through the API
    - `previous` string, nullable: Link to navigate to the previous page through the API
    - `current` string: Link to navigate to the current page through the API
    - `next` string, nullable: Link to navigate to the previous page through the API
  - `_raw` Raw, nullable: Raw response from the integration when raw=true query param is provided

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `404`: The specified resource was not found
- `422`: Unprocessable
- `default`: Unexpected error

## Changes

- **2026-10-13** `9f019cdb65cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apideck-libraries/apis/accounting-api/changes/accounting/fiscal-periods/get.md)

---

[API](https://skmtc.dev/apideck-libraries/apis/accounting-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/accounting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apideck-libraries/apis/accounting-api/revisions/d02fc67b26ca?raw)