GET
View a fiscal year (client account)
Client space Accounting module For: Accountant · Permission: fiscal_years.retrieve Conditions
  • The accounting module must be part of the organization’s plan.
Part of Fiscal years and periods.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

fiscalYear
string
required

Identifier of the fiscal year (27-character KSUID).

Query Parameters

response
enum<string>
default:resource

Response mode. Default resource; none answers 204 No Content.

Available options:
resource
fields
string

Comma-separated JSON keys of the root resource (id is always rendered). Available: id, owner_type, label, start_date, end_date, currency_code, currency_exponent, is_closed, closed_at, created_at, updated_at.

include
string

Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: .

Response

Resource.

id

Identifier of the fiscal year (27-character KSUID).

owner_type

Kind of book that owns the year; set by the server from the selected book.

label

Name of the fiscal year.

start_date

First day of the year, ISO 8601 date.

end_date

Last day of the year, ISO 8601 date.

currency_code

Three-letter currency code in which the year's entries are kept.

currency_exponent
integer

Number of decimal places of the currency (0 for XOF). An amount in minor units divided by 10 to this power gives the amount in the currency.

is_closed
boolean

True once the year is closed by the year-end closing; years start open.

closed_at

When the year was closed, ISO 8601; null while it is open or after it is reopened.

created_at

Date and time the record was created (ISO 8601, UTC).

updated_at

Date and time the record was last changed (ISO 8601, UTC).