Create a bank repo program

POST/bank-repo-programs

Fresh verified staff with ledger:repo:write is required. Retains actual bank legal entity, master ledger/external identity, lender/intermediary identities, cash keys, original custody identity, supported fixed simple interest terms and current reviewed legal/accounting authority. Bank-borrower secured borrowing only; no reverse repo, customer deposit, asset sale, reuse, substitution, automatic renewal or certification is implied. Every route requires verified non-API-key authority even locally; customer actors are refused. JSON evidence is one strict object bounded at 5 MiB. Complete responses are bounded at 16 MiB and fail explicitly without truncation.

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

agreementobjectRequired

3 child attributes

datastring · byteRequired

formatstringRequired

sha256stringRequired

authorityobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

cash_bridge_subjectstringRequired

cash_evidence_keysobjectRequired

custodian_referencestringRequired

custody_bridge_subjectstringRequired

custody_providerstringRequired

enabledbooleanRequired

haircut_bpsintegerRequired

intermediariesarray of objectsRequired

4 child attributes

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

external_referencestringRequired

identityobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

legal_namestringRequired

legal_entitystringRequired

lenderobjectRequired

4 child attributes

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

external_referencestringRequired

identityobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

legal_namestringRequired

master_cash_external_account_referencestringRequired

master_cash_identityobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

master_cash_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

max_excess_collateral_amountintegerRequired

max_principal_amountintegerRequired

max_rate_bpsintegerRequired

max_term_daysintegerRequired

providerstringRequired

termsobjectRequired

Terms are reviewed contract requirements. True/false assertions alone cannot establish their legal enforceability; the retained opinions and agreement do.

18 child attributes

accountingstringRequired

Secured_borrowing

accounting_opinionobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

automatic_renewalboolean or nullOptional

bank_entitled_and_obligatedboolean or nullOptional

concurrent_repurchase_agreementboolean or nullOptional

counterparty_may_reuseboolean or nullOptional

day_countstringRequired

Actual_360 or actual_365

default_policystringRequired

Preserve_obligation_governed_resolution

default_proceduresobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

early_terminationboolean or nullOptional

enforceability_opinionobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

floating_rateboolean or nullOptional

margin_policystringRequired

Daily_two_sided_review

margin_proceduresobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

roundingstringRequired

Cumulative_half_up_cent

same_securities_returnboolean or nullOptional

segregated_collateralboolean or nullOptional

substitutionboolean or nullOptional

valid_fromstring · dateRequired

A business date, YYYY-MM-DD

valid_throughstring · dateRequired

A business date, YYYY-MM-DD

Returns

200 OK

The Bank Repo Program 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/bank-repo-programs' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "agreement": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "authority": {
      "reference": "string",
      "sha256": "string"
    },
    "cash_bridge_subject": "string",
    "cash_evidence_keys": {},
    "custodian_reference": "string",
    "custody_bridge_subject": "string",
    "custody_provider": "string",
    "enabled": false,
    "haircut_bps": 0,
    "intermediaries": [
      {
        "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "external_reference": "string",
        "identity": {
          "reference": "string",
          "sha256": "string"
        },
        "legal_name": "string"
      }
    ],
    "legal_entity": "string",
    "lender": {
      "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "external_reference": "string",
      "identity": {
        "reference": "string",
        "sha256": "string"
      },
      "legal_name": "string"
    },
    "master_cash_external_account_reference": "string",
    "master_cash_identity": {
      "reference": "string",
      "sha256": "string"
    },
    "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "max_excess_collateral_amount": 10000,
    "max_principal_amount": 10000,
    "max_rate_bps": 0,
    "max_term_days": 0,
    "provider": "string",
    "terms": {
      "accounting": "string",
      "accounting_opinion": {
        "reference": "string",
        "sha256": "string"
      },
      "automatic_renewal": false,
      "bank_entitled_and_obligated": false,
      "concurrent_repurchase_agreement": false,
      "counterparty_may_reuse": false,
      "day_count": "string",
      "default_policy": "string",
      "default_procedures": {
        "reference": "string",
        "sha256": "string"
      },
      "early_termination": false,
      "enforceability_opinion": {
        "reference": "string",
        "sha256": "string"
      },
      "floating_rate": false,
      "margin_policy": "string",
      "margin_procedures": {
        "reference": "string",
        "sha256": "string"
      },
      "rounding": "string",
      "same_securities_return": false,
      "segregated_collateral": false,
      "substitution": false
    },
    "valid_from": "2026-09-17",
    "valid_through": "2026-09-17"
  }'

Response200

{
  "actor": "string",
  "content_sha256": "string",
  "created_at": "2026-09-17T14:30:00Z",
  "decision": {
    "actor": "string",
    "at": "2026-09-17T14:30:00Z",
    "content_sha256": "string",
    "decision": "string",
    "note": "string"
  },
  "id": "string",
  "kind": "string",
  "program": {
    "agreement": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "authority": {
      "reference": "string",
      "sha256": "string"
    },
    "cash_bridge_subject": "string",
    "cash_evidence_keys": {},
    "custodian_reference": "string",
    "custody_bridge_subject": "string",
    "custody_provider": "string",
    "enabled": false,
    "haircut_bps": 0,
    "intermediaries": [
      {
        "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "external_reference": "string",
        "identity": {},
        "legal_name": "string"
      }
    ],
    "legal_entity": "string",
    "lender": {
      "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "external_reference": "string",
      "identity": {
        "reference": "string",
        "sha256": "string"
      },
      "legal_name": "string"
    },
    "master_cash_external_account_reference": "string",
    "master_cash_identity": {
      "reference": "string",
      "sha256": "string"
    },
    "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "max_excess_collateral_amount": 10000,
    "max_principal_amount": 10000,
    "max_rate_bps": 0,
    "max_term_days": 0,
    "provider": "string",
    "terms": {
      "accounting": "string",
      "accounting_opinion": {
        "reference": "string",
        "sha256": "string"
      },
      "automatic_renewal": false,
      "bank_entitled_and_obligated": false,
      "concurrent_repurchase_agreement": false,
      "counterparty_may_reuse": false,
      "day_count": "string",
      "default_policy": "string",
      "default_procedures": {
        "reference": "string",
        "sha256": "string"
      },
      "early_termination": false,
      "enforceability_opinion": {
        "reference": "string",
        "sha256": "string"
      },
      "floating_rate": false,
      "margin_policy": "string",
      "margin_procedures": {
        "reference": "string",
        "sha256": "string"
      },
      "rounding": "string",
      "same_securities_return": false,
      "segregated_collateral": false,
      "substitution": false
    },
    "valid_from": "2026-09-17",
    "valid_through": "2026-09-17"
  }
}