Create a bank securities classification
/ledger/securities/classificationsFresh verified non-API-key staff with ledger:securities:write required. Proposes the next version of an approved instrument's classification: designation (available_for_sale; held_to_maturity is refused 422 because the program's accounting policy admits AFS only), rcb_line (a retained FFIEC 051 Schedule RC-B body item: 1, 2, 3, 4a1, 4a2, 4b1, 4b2, 4b3, 4c1a, 4c1b, 4c2a, 4c2b, 5a, 5b, 6a or 6b), rate_type (fixed or floating), structured_note (items 2, 3, 5 and 6 only), effective_date, evidence and rationale. A Treasury bill, the only instrument kind, is refused 422 unless it is item 1, fixed rate and not structured. The version binds the instrument's exact content digest; a new version must take effect after the approved one and is refused 409 while another awaits review. The database refuses the same.
Headers
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
basisobjectRequired2 child attributes
referencestringRequiredsha256stringRequireddesignationstringRequiredeffective_datestring · dateRequiredA business date, YYYY-MM-DD
instrument_idstringRequiredrate_typestringRequiredrationalestringRequiredrcb_linestringRequiredstructured_notebooleanRequiredReturns
200 OK
Errors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503