Home/Accounting/Journal Entries

Journal Entries

Manage the full journal entry lifecycle: create, update, post, and void.

Endpoints

GET	/api/v1/accounting/journals	List journal entries
POST	/api/v1/accounting/journals	Create a journal entry
GET	/api/v1/accounting/journals/{id}	Get a journal entry
PATCH	/api/v1/accounting/journals/{id}	Update a journal entry
DELETE	/api/v1/accounting/journals/{id}	Delete a journal entry
POST	/api/v1/accounting/journals/{id}/post	Post a journal entry
POST	/api/v1/accounting/journals/{id}/void	Void a journal entry

GET/api/v1/accounting/journals

List journal entries

Authentication required— Include session cookie or Bearer token

Query Parameters

Name	Type	Required	Description
fiscal_year_id	string	Optional	Filter by fiscal year ID
status	string	Optional	Filter by status (draft / posted / void)
search	string	Optional	Search by description
limit	integer	Optional	Number of items to return (default: 20, max: 100)
offset	integer	Optional	Offset for pagination (default: 0)

Code Examples

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

POST/api/v1/accounting/journals

Create a journal entry

Authentication required— Include session cookie or Bearer token

Request Body

Name	Type	Required	Description
date	string	Required	Journal date (YYYY-MM-DD)
fiscal_year_id	string	Required	Fiscal year ID
description	string	Optional	Description
	object[]	Required	Journal lines

Code Examples

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

GET/api/v1/accounting/journals/{id}

Get a journal entry

Authentication required— Include session cookie or Bearer token

Path Parameters

Name	Type	Required	Description
id	string	Optional	Journal entry ID

Code Examples

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

PATCH/api/v1/accounting/journals/{id}

Update a journal entry

Authentication required— Include session cookie or Bearer token

Path Parameters

Name	Type	Required	Description
id	string	Optional	Journal entry ID

Request Body

Name	Type	Required	Description
date	string	Optional	Journal date (YYYY-MM-DD)
description	string	Optional	Description
	object[]	Optional	Journal lines

Code Examples

curl -X PATCH "https://api.blueai.jp/api/v1/accounting/journals/je_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"

DELETE/api/v1/accounting/journals/{id}

Delete a journal entry

Authentication required— Include session cookie or Bearer token

Path Parameters

Name	Type	Required	Description
id	string	Optional	Journal entry ID

Code Examples

curl -X DELETE "https://api.blueai.jp/api/v1/accounting/journals/je_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"

POST/api/v1/accounting/journals/{id}/post

Post a journal entry

Post (finalize) a draft journal entry. Once posted, it cannot be edited.

Authentication required— Include session cookie or Bearer token

Path Parameters

Name	Type	Required	Description
id	string	Optional	Journal entry ID

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/accounting/journals/je_123e4567e89b12d3a456426614174000/post" \
  -H "Cookie: better-auth.session_token=<token>"

POST/api/v1/accounting/journals/{id}/void

Void a journal entry

Void a posted journal entry. A reversing entry is automatically created.

Authentication required— Include session cookie or Bearer token

Path Parameters

Name	Type	Required	Description
id	string	Optional	Journal entry ID

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/accounting/journals/je_123e4567e89b12d3a456426614174000/void" \
  -H "Cookie: better-auth.session_token=<token>"