PEpennylane
Fiscal years

List Company's Fiscal Years

Changed on

This endpoint returns a list of fiscal years of the company. By default, returns fiscal years ordered by descending IDs. A sort query parameter is available allowing to sort by id or start attributes.

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

get/api/external/v2/fiscal_years

Request

  • Base URL
    https://app.pennylane.com
  • URL
    https://app.pennylane.com/api/external/v2/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:readonly

Query parameters

cursorstring
Example:MjAyNS0wMS0wOVQwODoyNDozOC44MTI0NTha

Cursor for pagination. 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.

limitinteger

Number of items to return per request. Defaults to 20 if not specified. Must be between 1 and 100.

sortstring
Example:id

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

Headers

X-Company-Idstring
Example:12345

Numeric ID of the company to act on. Required when authenticating with a firm token. Ignored when the token is already bound to a company.

Response

Returns the list of fiscal years of the company

has_moreboolean required

Indicates whether additional results are available beyond this set. Use this flag to determine if another request is needed.

next_cursorstring nullable required

Cursor to retrieve the next set of results. Include this value in the cursor parameter of your next request to fetch subsequent items. A null next_cursor in the response indicates no further results.

Example response

{
  "items": [
    {
      "id": 12,
      "start": "2023-08-30",
      "finish": "2022-12-31",
      "status": "open",
      "created_at": "2023-08-30T10:08:08.146343Z",
      "updated_at": "2023-08-30T10:08:08.146343Z"
    }
  ],
  "has_more": true
}

Changes