Ledgers

Create ledger

Creates a new ledger for an account holder in the specified currency.

One ledger per account_holder per currency (enforced by unique constraint). The currency field is authoritative for the entire ledger hierarchy.

post/api/ledgers

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/ledgers
  • Auth: none required

Request body

account_holder_idstring uuid required
currencystring required

ISO 4217 three-letter currency code (e.g. USD). Authoritative for the entire ledger hierarchy.

ledger_numberstring nullable

Opaque external SoE identifier (upsert identity)

status'active' | 'closed' nullable
tenant_idstring uuid

Example request

{
  "account_holder_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "currency": "",
  "ledger_number": "",
  "status": "active",
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.