Create an investment distribution

POST/investment-distributions

Only the exact configured service with payments:investments:bridge supplies actual signed MMF cash income or full Treasury maturity evidence. Exact actor/key/input and unique external event replay protect cash. Gross, withholding, fees, net cash and actual provider tax character are retained separately. Treasury gross is full redeemed face once, never face plus the discount again; reaching maturity or projecting dividends is not receipt of cash. Competing sale/maturity cannot dispose the same lot twice.

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

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

custody_evidenceobjectRequired

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

3 child attributes

datastring · byteRequired

formatstringRequired

sha256stringRequired

external_account_referencestringRequired

fee_amountintegerRequired

gross_amountintegerRequired

idstringRequired

key_idstringRequired

kindstringRequired

Cash_distribution or maturity

lot_idstringRequired

lot_revisionintegerRequired

net_cash_amountintegerRequired

observed_atstring · date-timeRequired

original_settlement_sha256stringRequired

owner_idstringRequired

payment_datestring · dateRequired

A business date, YYYY-MM-DD

payment_referencestringRequired

record_datestring · dateRequired

A business date, YYYY-MM-DD

signaturestringRequired

tax_characterstringRequired

Explicit actual classification, including unknown

tax_evidenceobjectRequired

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

3 child attributes

datastring · byteRequired

formatstringRequired

sha256stringRequired

unitsintegerRequired

Original full lot; distribution does not remove units

versionstringRequired

withholding_amountintegerRequired

Returns

200 OK

The Investment Distribution 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-distributions' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cash_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "cash_reference": "string",
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "custody_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "external_account_reference": "string",
    "fee_amount": 10000,
    "gross_amount": 10000,
    "id": "string",
    "key_id": "string",
    "kind": "string",
    "lot_id": "string",
    "lot_revision": 0,
    "net_cash_amount": 10000,
    "observed_at": "2026-09-17T14:30:00Z",
    "original_settlement_sha256": "string",
    "owner_id": "string",
    "payment_date": "2026-09-17",
    "payment_reference": "string",
    "record_date": "2026-09-17",
    "signature": "string",
    "tax_character": "string",
    "tax_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "units": 0,
    "version": "string",
    "withholding_amount": 10000
  }'

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",
  "created_at": "2026-09-17T14:30:00Z",
  "exceptions": [
    "string"
  ],
  "id": "string",
  "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "posting_date": "2026-09-17",
  "receipt": {
    "cash_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "cash_reference": "string",
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "custody_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "external_account_reference": "string",
    "fee_amount": 10000,
    "gross_amount": 10000,
    "id": "string",
    "key_id": "string",
    "kind": "string",
    "lot_id": "string",
    "lot_revision": 0,
    "net_cash_amount": 10000,
    "observed_at": "2026-09-17T14:30:00Z",
    "original_settlement_sha256": "string",
    "owner_id": "string",
    "payment_date": "2026-09-17",
    "payment_reference": "string",
    "record_date": "2026-09-17",
    "signature": "string",
    "tax_character": "string",
    "tax_evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "units": 0,
    "version": "string",
    "withholding_amount": 10000
  },
  "request_sha256": "string",
  "resolutions": [
    {
      "actor": "string",
      "at": "2026-09-17T14:30:00Z",
      "content_sha256": "string",
      "decision": "string",
      "note": "string"
    }
  ],
  "status": "string"
}