---
title: "List all periods of a company"
method: GET
path: "/api/v4/f/{firm_id}/companies/{company_id}/periods"
tags: ["Periods"]
---

# List all periods of a company

`GET /api/v4/f/{firm_id}/companies/{company_id}/periods`

## Request

- Base URL: `https://live.getsilverfin.com`
- URL: `https://live.getsilverfin.com/api/v4/f/{firm_id}/companies/{company_id}/periods`
- Auth: OAuth 2
  - Authorization code: `https://live.getsilverfin.com/oauth/authorize`
  - Token URL: `https://live.getsilverfin.com/oauth/token` scopes: `communication:read, financials:read`

List all periods of a company. <br>
<b>Required scope(s):</b> `communication:read, financials:read`

## Path parameters

- `firm_id` integer, required
- `company_id` integer, required

## Query parameters

- `page` integer
- `per_page` integer
- `public` boolean: If set to true, then only the public periods will be listed in the response. If set to false, only private periods will be provided. Leave blank if you want to return all periods.

## Headers

- `Accept` string
- `Accept-Language` string

## Response `200`

Successful response

- object[]
  - `id` integer: period_id
  - `end_date` string
  - `public` boolean
  - `fiscal_year` object
    - `start_date` string
    - `end_date` string
  - `extra_data_headers` string[]
  - `locked` boolean
  - `locked_permanently` boolean

---

[API](https://skmtc.dev/silverfin/apis/silverfin-api.md) - [All operations](https://skmtc.dev/silverfin/apis/silverfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverfin/apis/silverfin-api/revisions/e418e4fc02e8?raw)