Create an investment order

POST/investment-orders

Fresh verified bound customer with customer scope consents to exact owner, account, current controls, disclosure, full quantity, price limit, fee limit and maximum BUY debit or minimum SELL proceeds. Staff cannot manufacture customer consent. Only individual single-owner USD custody is supported. Shared payment limits apply to BUY requests; exclusive full-lot reservation prevents short or competing sales. Actor/key/input replay retains the original stable order and lot identities.

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

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

cash_limit_amountintegerRequired

BUY maximum total debit; SELL minimum net credit

currency_codestringRequired

custody_account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

disclosure_sha256stringRequired

instrument_idstringRequired

investment_consentbooleanRequired

limit_priceintegerRequired

lot_idstringOptional

max_fee_amountintegerRequired

owner_idstringRequired

program_idstringRequired

settlement_datestring · dateRequired

A business date, YYYY-MM-DD

sidestringRequired

BUY or SELL

trade_datestring · dateRequired

A business date, YYYY-MM-DD

unitsintegerRequired

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' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "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,
    "max_fee_amount": 10000,
    "owner_id": "string",
    "program_id": "string",
    "settlement_date": "2026-09-17",
    "side": "string",
    "trade_date": "2026-09-17",
    "units": 0
  }'

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"
}