Create a collateral pledge

POST/ledger/collateral/pledges

The ledger's guard admits ledger:treasury:write on this route and refuses ledger:post; the store admits only verified treasury staff (never a service or an API key) who stepped up within five minutes. One live pledge per asset across every program, refused 409 conflict. A loan's facts are read from lending and the reservation is mirrored onto the loan after it commits; if lending does not answer the reservation stands and the call answers 424 dependency_failed, and replaying the key repeats the mirror.

Headers

Idempotency-KeystringRequired

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

asset_kindstringRequired

Securities_lot or loan

lender_idintegerRequired

referencestringRequired

The lot or loan id

Returns

200 OK

The Collateral Pledge object.

Errors

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

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/ledger/collateral/pledges' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_kind": "string",
    "lender_id": 0,
    "reference": "string"
  }'

Response200

{
  "asset": {
    "asset_class": "string",
    "id": 0,
    "kind": "string",
    "loan": {
      "as_of": "2026-09-17",
      "asset_class": "string",
      "charged_off": false,
      "days_past_due": 0,
      "loan_id": "loan_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "maturity_date": "2026-09-17",
      "maturity_unresolved": false,
      "nonaccrual": false,
      "participations_sold_amount": 10000,
      "product_code": "string",
      "status": "string",
      "unpaid_principal_amount": 10000
    },
    "maturity_date": "2026-09-17",
    "maturity_unresolved": false,
    "reference": "string",
    "updated_at": "2026-09-17T14:30:00Z",
    "valuation_as_of": "2026-09-17",
    "valuation_basis": "string",
    "valuation_sha256": "string",
    "value_amount": 10000
  },
  "created_at": "2026-09-17T14:30:00Z",
  "eligible": false,
  "haircut_bps": 0,
  "id": 0,
  "ineligibility": [
    "string"
  ],
  "lendable_amount": 10000,
  "lender_id": 0,
  "maker": "string",
  "pledge_reference": "string",
  "state": "string",
  "updated_at": "2026-09-17T14:30:00Z",
  "value_amount": 10000
}