LedgerLou Docs is optimized for desktop.

Please open this page on a device with a wider screen.

Periods

Create lock request (four-eyes principle)

Creates a lock request for a period. A second user must approve the request before the period is permanently locked. Lock requests expire after 48 hours.

POST /v1/periods/:period/lock
Authorization
Authorization string header required API key in the format ll_.... Pass as a Bearer token.
Responses
201
Success
400
INVALID_INPUT The period format is invalid.
404
NOT_FOUND The specified adjustment period does not exist.
409
PERIOD_ALREADY_LOCKED The period is already hard-locked.
409
LOCK_REQUEST_PENDING A pending lock request already exists for this period.
POST /v1/periods/:period/lock
cURL
-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/periods/:period/lock' -punct">\
  --header 'Authorization: Bearer ll_your_key'
201 Response
JSON
{
  "request_id": "<string>",
  "period": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "message": "<string>"
}