Skip to main content
BlueAI
Home/Accounting/Fiscal Years

Fiscal Years

Create, list, and close fiscal years.

|

Endpoints

GET/api/v1/accounting/fiscal-yearsList fiscal years
POST/api/v1/accounting/fiscal-yearsCreate a fiscal year
POST/api/v1/accounting/fiscal-years/{id}/closeClose a fiscal year
GET/api/v1/accounting/fiscal-years

List fiscal years

Authentication requiredInclude session cookie or Bearer token

Query Parameters

NameTypeRequiredDescription
limit
integerOptionalNumber of items to return (default: 20, max: 100)
offset
integerOptionalOffset for pagination (default: 0)

Code Examples

curl "https://api.blueai.jp/api/v1/accounting/fiscal-years" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/accounting/fiscal-years

Create a fiscal year

Authentication requiredInclude session cookie or Bearer token

Request Body

NameTypeRequiredDescription
name
stringRequiredFiscal year name (e.g., FY2026)
start_date
stringRequiredStart date (YYYY-MM-DD)
end_date
stringRequiredEnd date (YYYY-MM-DD)

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/accounting/fiscal-years" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/accounting/fiscal-years/{id}/close

Close a fiscal year

Close a fiscal year, preventing further journal entries.

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalFiscal year ID

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/accounting/fiscal-years/fy_123e4567e89b12d3a456426614174000/close" \
  -H "Cookie: better-auth.session_token=<token>"