PEpennylane
Fiscal years

Create a fiscal year

Create a fiscal year. Fiscal years must be consecutive and cannot overlap.

ℹ️ This endpoint requires the following scope: fiscal_years:all

post/api/external/firm/v1/companies/{company_id}/fiscal_years

Request

  • Base URL
    https://app.pennylane.com
  • URL
    https://app.pennylane.com/api/external/firm/v1/companies/{company_id}/fiscal_years
  • Auth
    OAuth 2
    Authorization code: https://app.pennylane.com/oauth/authorize
    Token URL: https://app.pennylane.com/oauth/oauth/token scopes: fiscal_years:all

Path parameters

company_idinteger required

Existing company identifier (id)

Request body

startstring date required

The date at which the fiscal year starts (ISO 8601). Fiscal years must be consecutive and cannot overlap.

finishstring date required

The date at which the fiscal year ends (ISO 8601)

Example request

{
  "start": "2026-01-01",
  "finish": "2026-12-31"
}

Response

Returns the created fiscal year

idinteger required
startstring date required

The date at which the fiscal year starts.

finishstring date required

The date at which the fiscal year ends.

status'open' | 'reopen' | 'closed' | 'frozen' required

The status of the fiscal year.

Example response

{
  "start": "2023-08-30",
  "finish": "2022-12-31",
  "status": "open"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.