Home/Accounting/Period Locks

Period Locks

Lock and unlock journal entry input on a monthly basis.

Endpoints

GET	/api/v1/accounting/period-locks	List period locks
POST	/api/v1/accounting/period-locks	Create a period lock
DELETE	/api/v1/accounting/period-locks/{id}	Delete a period lock

GET/api/v1/accounting/period-locks

List period locks

Authentication required— Include session cookie or Bearer token

Query Parameters

Name	Type	Required	Description
fiscal_year_id	string	Optional	Filter by fiscal year ID
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/period-locks" \
  -H "Cookie: better-auth.session_token=<token>"

POST/api/v1/accounting/period-locks

Create a period lock

Authentication required— Include session cookie or Bearer token

Request Body

Name	Type	Required	Description
fiscal_year_id	string	Required	Fiscal year ID
year_month	string	Required	Target month to lock (YYYY-MM)

Code Examples

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

DELETE/api/v1/accounting/period-locks/{id}

Delete a period lock

Authentication required— Include session cookie or Bearer token

Path Parameters

Name	Type	Required	Description
id	string	Optional	Period lock ID

Code Examples

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