List Company's Fiscal Years

get

https://app.pennylane.com/api/external/v2/fiscal_years

This endpoint returns a list of fiscal years of the company.

DEPRECATED BEHAVIOR: By default, returns fiscal years ordered by ascending start date.

NEW BEHAVIOR: By default, returns fiscal years ordered by descending IDs A new sort query parameter is now available allowing to sort by id or start attributes. For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions.

This endpoint requires the following scope: fiscal_years:readonly

Query Params

use_2026_api_changes

boolean

Defaults to true

If you are already using the X-Use-2026-API-Changes header, you can ignore this parameter.

The Pennylane API is introducing important changes, which will be rolled out in three phases: preview, sunset and cleanup.

For new user, please use this parameter with true value to opt in directly to the new version of the API.

Preview phase: From January 14th to April 7th 2026. Opt in by setting this attribute to true to test and migrate to the new behavior.

Sunset phase: From April 8th to June 30th 2026. The new behavior becomes the default. Set this attribute to false if you need additional time to migrate.

Cleanup phase: Starting July 1st 2026 The old behavior will no longer be available. You must have migrated by this point.

For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions.

page

integer

deprecated

This pagination system is DEPRECATED. For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions. Items are paginated, this is the current page which will be returned. The page index is starting at 1.

per_page

integer

1 to 100

deprecated

This pagination system is DEPRECATED. For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions. Items are paginated. By default, you get 20 items per page. You can specify another number of items per page.

cursor

string

This pagination system is only available in the new version of the API. For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions. Use this to fetch the next set of results. The cursor is an opaque string returned in the previous response's metadata. Leave empty for the first request.

limit

integer

1 to 100

This pagination system is only available in the new version of the API. For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions. Number of items to return per request. Defaults to 20 if not specified. Must be between 1 and 100.

sort

string

You can choose to sort items on specific attributes Sort field may be prefixed with - for descending order. Example : id will sort by ascending order, -id will sort by descending order. Available fields :

id, start

Responses

400Bad request

401Access token is missing or invalid

403Access to this resource forbidden

404The resource was not found