---
title: "Add a period"
method: POST
path: "/api/v4/f/{firm_id}/companies/{company_id}/periods"
tags: ["Periods"]
---

# Add a period

`POST /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: `financials:write`

Add a period. <br>
<b>Required scope(s):</b> `financials:write`

## Path parameters

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

## Headers

- `Accept` string

## Request body `multipart/form-data`

- object
  - `end_date` string, date, required

## Response `201`

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

## Changes

- **2026-11-03** `e418e4fc02e8`: 2 info
  - the security scope `financials:write` was added to the endpoint's security scheme `OAuth2`
  - the security scope `financials:read, financials:write` was removed from the endpoint's security scheme `OAuth2`

[Operation history](https://skmtc.dev/silverfin/apis/silverfin-api/changes/api/v4/f/:firm_id/companies/:company_id/periods/post.md)

---

[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)