Verify actual signed cash and beneficial custody delivery before booking securities settlement

POST/investment-orders/{id}/settlement

Only the exact configured service with payments:investments:bridge submits signed actual cash and customer beneficial custody delivery, bound to the retained full execution. Receipt is retained before accounting, external evidence cannot fund two orders, and saved exact journal plans recover uncertain replies without duplicate cash. Late actual settlement retains its original date and exception. BUY removes DDA liability only after actual paid DVP; SELL restores actual received net cash. Customer securities never become bank-owned investment assets.

Path parameters

idstringRequired

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

broker_referencestringRequired

cash_evidenceobjectRequired

Document retains the actual external bytes, not a mutable reference alone.

3 child attributes

datastring · byteRequired

formatstringRequired

sha256stringRequired

cash_referencestringRequired

currency_codestringRequired

cusipstringRequired

custodian_referencestringRequired

delivery_evidenceobjectRequired

Document retains the actual external bytes, not a mutable reference alone.

3 child attributes

datastring · byteRequired

formatstringRequired

sha256stringRequired

delivery_referencestringRequired

execution_sha256stringRequired

external_account_referencestringRequired

fee_amountintegerRequired

instruction_sha256stringRequired

key_idstringRequired

net_cash_amountintegerRequired

observed_atstring · date-timeRequired

order_idstringRequired

owner_idstringRequired

principal_amountintegerRequired

settled_atstring · date-timeRequired

settlement_datestring · dateRequired

A business date, YYYY-MM-DD

settlement_referencestringRequired

sidestringRequired

signaturestringRequired

unitsintegerRequired

versionstringRequired

Returns

200 OK

The Investment Order 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/investment-orders/{id}/settlement' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broker_reference": "string",
    "cash_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "cash_reference": "string",
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "delivery_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "delivery_reference": "string",
    "execution_sha256": "string",
    "external_account_reference": "string",
    "fee_amount": 10000,
    "instruction_sha256": "string",
    "key_id": "string",
    "net_cash_amount": 10000,
    "observed_at": "2026-09-17T14:30:00Z",
    "order_id": "string",
    "owner_id": "string",
    "principal_amount": 10000,
    "settled_at": "2026-09-17T14:30:00Z",
    "settlement_date": "2026-09-17",
    "settlement_reference": "string",
    "side": "string",
    "signature": "string",
    "units": 0,
    "version": "string"
  }'

Response200

{
  "accounting_plan_sha256": "string",
  "accounting_plans": [
    {
      "correction_reason": "string",
      "created_at": "2026-09-17T14:30:00Z",
      "evidence_sha256": "string",
      "journal": {
        "adjusts_period": "string",
        "effective_date": "2026-09-17",
        "entries": [],
        "kind": "string",
        "protected_command_id": "string",
        "reason": "string",
        "release_hold_id": "hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "require_available": false,
        "reversal_of": "string",
        "source_ref": "string",
        "source_service": "string"
      },
      "journal_key": "string",
      "journal_sha256": "string",
      "supersedes_sha256": "string"
    }
  ],
  "actor": "string",
  "cash_hold_id": "hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "created_at": "2026-09-17T14:30:00Z",
  "custody_account": {
    "actor": "string",
    "content_sha256": "string",
    "created_at": "2026-09-17T14:30:00Z",
    "custody_account": {
      "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "custodian_reference": "string",
      "enabled": false,
      "exclusive_core_instructions": false,
      "external_account_reference": "string",
      "key_id": "string",
      "observed_at": "2026-09-17T14:30:00Z",
      "onboarding": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "opening_inventory_empty": false,
      "owner_id": "string",
      "ownership": {
        "reference": "string",
        "sha256": "string"
      },
      "program_id": "string",
      "program_sha256": "string",
      "signature": "string",
      "valid_until": "2026-09-17T14:30:00Z",
      "version": "string"
    },
    "decision": {
      "actor": "string",
      "at": "2026-09-17T14:30:00Z",
      "content_sha256": "string",
      "decision": "string",
      "note": "string"
    },
    "id": "string",
    "instrument": {
      "currency_code": "USD",
      "cusip": "string",
      "eligibility": {
        "reference": "string",
        "sha256": "string"
      },
      "enabled": false,
      "face_value_amount": 10000,
      "government_only": false,
      "issue_date": "2026-09-17",
      "kind": "string",
      "maturity_date": "2026-09-17",
      "name": "string",
      "no_load": false,
      "price_scale": 0,
      "program_id": "string",
      "prospectus": {
        "reference": "string",
        "sha256": "string"
      },
      "unit_basis": "string",
      "unit_increment": 0,
      "unit_scale": 0,
      "zero_coupon": false
    },
    "kind": "string",
    "program": {
      "agency_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "authority": {
        "reference": "string",
        "sha256": "string"
      },
      "bank_remuneration": "string",
      "bridge_subject": "string",
      "broker_name": "string",
      "broker_reference": "string",
      "cash_rounding": "string",
      "confirmation_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "confirmation_provider": "string",
      "custodian_name": "string",
      "custodian_reference": "string",
      "custody_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "enabled": false,
      "evidence_keys": {},
      "legal_entity": "string",
      "max_order_amount": 10000,
      "provider": "string",
      "risk_disclosure": {
        "reference": "string",
        "sha256": "string"
      },
      "tax_reporter": "string",
      "tax_reporting_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "valid_from": "2026-09-17",
      "valid_through": "2026-09-17"
    }
  },
  "customer_hold_id": "hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "decision": {
    "actor": "string",
    "at": "2026-09-17T14:30:00Z",
    "content_sha256": "string",
    "decision": "string",
    "note": "string"
  },
  "exceptions": [
    "string"
  ],
  "execution": {
    "broker_reference": "string",
    "confirmation": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "confirmation_delivery": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "confirmation_received_at": "2026-09-17T14:30:00Z",
    "counterparty": "string",
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "delivered_at": "2026-09-17T14:30:00Z",
    "delivery_method": "string",
    "delivery_recipient_id": "string",
    "executed_at": "2026-09-17T14:30:00Z",
    "execution_reference": "string",
    "external_account_reference": "string",
    "fee_amount": 10000,
    "instruction_sha256": "string",
    "key_id": "string",
    "net_cash_amount": 10000,
    "observed_at": "2026-09-17T14:30:00Z",
    "order_id": "string",
    "owner_id": "string",
    "price": 0,
    "principal_amount": 10000,
    "side": "string",
    "signature": "string",
    "status": "string",
    "trade_date": "2026-09-17",
    "units": 0,
    "version": "string"
  },
  "id": "string",
  "instruction": {
    "broker_reference": "string",
    "cash_limit_amount": 10000,
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "custody_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "custody_account_sha256": "string",
    "external_account_reference": "string",
    "id": "string",
    "instrument_id": "string",
    "instrument_sha256": "string",
    "issued_at": "2026-09-17T14:30:00Z",
    "limit_price": 0,
    "lot_id": "string",
    "lot_revision": 0,
    "max_fee_amount": 10000,
    "order_id": "string",
    "owner_id": "string",
    "price_scale": 0,
    "program_id": "string",
    "program_sha256": "string",
    "request_sha256": "string",
    "settlement_date": "2026-09-17",
    "sha256": "string",
    "side": "string",
    "trade_date": "2026-09-17",
    "unit_basis": "string",
    "unit_scale": 0,
    "units": 0,
    "version": "string"
  },
  "instrument": {
    "actor": "string",
    "content_sha256": "string",
    "created_at": "2026-09-17T14:30:00Z",
    "custody_account": {
      "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "custodian_reference": "string",
      "enabled": false,
      "exclusive_core_instructions": false,
      "external_account_reference": "string",
      "key_id": "string",
      "observed_at": "2026-09-17T14:30:00Z",
      "onboarding": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "opening_inventory_empty": false,
      "owner_id": "string",
      "ownership": {
        "reference": "string",
        "sha256": "string"
      },
      "program_id": "string",
      "program_sha256": "string",
      "signature": "string",
      "valid_until": "2026-09-17T14:30:00Z",
      "version": "string"
    },
    "decision": {
      "actor": "string",
      "at": "2026-09-17T14:30:00Z",
      "content_sha256": "string",
      "decision": "string",
      "note": "string"
    },
    "id": "string",
    "instrument": {
      "currency_code": "USD",
      "cusip": "string",
      "eligibility": {
        "reference": "string",
        "sha256": "string"
      },
      "enabled": false,
      "face_value_amount": 10000,
      "government_only": false,
      "issue_date": "2026-09-17",
      "kind": "string",
      "maturity_date": "2026-09-17",
      "name": "string",
      "no_load": false,
      "price_scale": 0,
      "program_id": "string",
      "prospectus": {
        "reference": "string",
        "sha256": "string"
      },
      "unit_basis": "string",
      "unit_increment": 0,
      "unit_scale": 0,
      "zero_coupon": false
    },
    "kind": "string",
    "program": {
      "agency_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "authority": {
        "reference": "string",
        "sha256": "string"
      },
      "bank_remuneration": "string",
      "bridge_subject": "string",
      "broker_name": "string",
      "broker_reference": "string",
      "cash_rounding": "string",
      "confirmation_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "confirmation_provider": "string",
      "custodian_name": "string",
      "custodian_reference": "string",
      "custody_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "enabled": false,
      "evidence_keys": {},
      "legal_entity": "string",
      "max_order_amount": 10000,
      "provider": "string",
      "risk_disclosure": {
        "reference": "string",
        "sha256": "string"
      },
      "tax_reporter": "string",
      "tax_reporting_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "valid_from": "2026-09-17",
      "valid_through": "2026-09-17"
    }
  },
  "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "lot_id": "string",
  "lot_revision": 0,
  "posting_date": "2026-09-17",
  "program": {
    "actor": "string",
    "content_sha256": "string",
    "created_at": "2026-09-17T14:30:00Z",
    "custody_account": {
      "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "custodian_reference": "string",
      "enabled": false,
      "exclusive_core_instructions": false,
      "external_account_reference": "string",
      "key_id": "string",
      "observed_at": "2026-09-17T14:30:00Z",
      "onboarding": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "opening_inventory_empty": false,
      "owner_id": "string",
      "ownership": {
        "reference": "string",
        "sha256": "string"
      },
      "program_id": "string",
      "program_sha256": "string",
      "signature": "string",
      "valid_until": "2026-09-17T14:30:00Z",
      "version": "string"
    },
    "decision": {
      "actor": "string",
      "at": "2026-09-17T14:30:00Z",
      "content_sha256": "string",
      "decision": "string",
      "note": "string"
    },
    "id": "string",
    "instrument": {
      "currency_code": "USD",
      "cusip": "string",
      "eligibility": {
        "reference": "string",
        "sha256": "string"
      },
      "enabled": false,
      "face_value_amount": 10000,
      "government_only": false,
      "issue_date": "2026-09-17",
      "kind": "string",
      "maturity_date": "2026-09-17",
      "name": "string",
      "no_load": false,
      "price_scale": 0,
      "program_id": "string",
      "prospectus": {
        "reference": "string",
        "sha256": "string"
      },
      "unit_basis": "string",
      "unit_increment": 0,
      "unit_scale": 0,
      "zero_coupon": false
    },
    "kind": "string",
    "program": {
      "agency_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "authority": {
        "reference": "string",
        "sha256": "string"
      },
      "bank_remuneration": "string",
      "bridge_subject": "string",
      "broker_name": "string",
      "broker_reference": "string",
      "cash_rounding": "string",
      "confirmation_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "confirmation_provider": "string",
      "custodian_name": "string",
      "custodian_reference": "string",
      "custody_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "enabled": false,
      "evidence_keys": {},
      "legal_entity": "string",
      "max_order_amount": 10000,
      "provider": "string",
      "risk_disclosure": {
        "reference": "string",
        "sha256": "string"
      },
      "tax_reporter": "string",
      "tax_reporting_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "valid_from": "2026-09-17",
      "valid_through": "2026-09-17"
    }
  },
  "request": {
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "cash_limit_amount": 10000,
    "currency_code": "USD",
    "custody_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "disclosure_sha256": "string",
    "instrument_id": "string",
    "investment_consent": false,
    "limit_price": 0,
    "lot_id": "string",
    "max_fee_amount": 10000,
    "owner_id": "string",
    "program_id": "string",
    "settlement_date": "2026-09-17",
    "side": "string",
    "trade_date": "2026-09-17",
    "units": 0
  },
  "request_sha256": "string",
  "resolutions": [
    {
      "actor": "string",
      "at": "2026-09-17T14:30:00Z",
      "content_sha256": "string",
      "decision": "string",
      "note": "string"
    }
  ],
  "screening_at": "2026-09-17T14:30:00Z",
  "screening_ids": [
    "string"
  ],
  "settlement": {
    "broker_reference": "string",
    "cash_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "cash_reference": "string",
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "delivery_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "delivery_reference": "string",
    "execution_sha256": "string",
    "external_account_reference": "string",
    "fee_amount": 10000,
    "instruction_sha256": "string",
    "key_id": "string",
    "net_cash_amount": 10000,
    "observed_at": "2026-09-17T14:30:00Z",
    "order_id": "string",
    "owner_id": "string",
    "principal_amount": 10000,
    "settled_at": "2026-09-17T14:30:00Z",
    "settlement_date": "2026-09-17",
    "settlement_reference": "string",
    "side": "string",
    "signature": "string",
    "units": 0,
    "version": "string"
  },
  "source": {
    "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "captured_at": "2026-09-17T14:30:00Z",
    "custody_ownership": {
      "reference": "string",
      "sha256": "string"
    },
    "external_account_reference": "string",
    "ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "owner_id": "string",
    "ownership_revision": 0,
    "ownership_sha256": "string"
  },
  "status": "string"
}