Corgi BankDocumentation
OpenAPI

Allocate actual unreversed payable credits to the verified source service and reserve them against generic spending

POST/ledger/payable-obligations

Verified owning svc_accounts or svc_lending with existing ledger:post is required even locally; staff, customers, API keys and other services cannot register sources. Allocate exact positive credits of an actual unreversed original journal; cumulative allocations cannot exceed the credited line. Independently identifies the account owner and optional tax recipient. SourceDateBasis is calendar_date when omitted; a calendar source date cannot be in the future. Explicit journal_posting_date requires exact equality with the verified original journal PostingDate, including a legitimate next-bank date after cutoff or during a weekend. The basis is retained in the source hash and does not infer a statutory deadline. Immutable native account-closure lineage is required to adopt a ledger-owned closure component. Exact issuer/kind/source-ID replay recovers one obligation and one funded native hold; changed replay conflicts. Existing spent legacy credits require reconciliation.

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

account_idstringOptional

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

amount_minorintegerRequired
currencystringRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

evidence_referencestringRequired
jurisdictionstringOptional
kindstringRequired
legal_entitystringRequired
loan_idstringOptional

Example loan_2tVh8nqLxq4GbDe0K1F6S9zRcWm

payee_referencestringOptional
sourceobjectRequired
6 child attributes
closure_componentstringOptional
closure_ledger_account_idstringOptional

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

journal_idstringRequired

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

journal_keystringRequired
journal_sha256stringRequired
ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

source_datestring · dateRequired

A business date, YYYY-MM-DD

source_date_basisstringOptional
source_idstringRequired
source_sha256stringRequired
tax_customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

tax_periodstringOptional

Returns

200 OK

account_idstringOptional

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

amount_minorintegerRequired
content_sha256stringRequired
created_atstring · date-timeRequired
currencystringRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

evidence_referencestringRequired
hold_idstringRequired

Example hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm

idstringRequired
issuerstringRequired
jurisdictionstringOptional
kindstringRequired
legal_entitystringRequired
loan_idstringOptional

Example loan_2tVh8nqLxq4GbDe0K1F6S9zRcWm

payee_referencestringOptional
sourceobjectRequired
6 child attributes
closure_componentstringOptional
closure_ledger_account_idstringOptional

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

journal_idstringRequired

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

journal_keystringRequired
journal_sha256stringRequired
ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

source_datestring · dateRequired

A business date, YYYY-MM-DD

source_date_basisstringOptional
source_idstringRequired
source_sha256stringRequired
tax_customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

tax_periodstringOptional

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

to move to open esc to close