---
title: "List accounting periods"
method: GET
path: "/v1/platform/accounting-periods/"
tags: ["Accounting Periods"]
---

# List accounting periods

`GET /v1/platform/accounting-periods/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/accounting-periods/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

Returns a list of accounting periods for a business with optional filtering.

        **Filtering**: Support for year, month, and status filters
        **Statuses**: open, soft_closed, hard_closed, audited

## Query parameters

- `business_id` string, uuid, required
- `page` integer
- `page_size` integer
- `status` string
- `year` integer

## Response `200`

- PaginatedAccountingPeriodList
  - `count` integer, required: Total number of items
  - `page_info` object, required
    - `total_count` integer, required: Total number of items (same as count)
    - `current_page` integer, required: Current page number (1-indexed)
    - `total_pages` integer, required: Total number of pages
    - `page_size` integer, required: Number of items per page
  - `results` AccountingPeriod[], required
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `year` integer, required
    - `month` integer, required
    - `period_name` string, required
    - `status` string, required
    - `start_date` string, date, required
    - `end_date` string, date, required
    - `is_locked` boolean, required
    - `allows_changes` boolean, required
    - `requires_override` boolean, required
    - `closed_at` string, date-time, nullable, required
    - `closed_by` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)