Get an investment control by ID

GET/investment-controls/{id}

Verified staff/service with payments:investments:read or payments:investments:write reads retained program, instrument or custody evidence and independent decision. Customers cannot read raw controls through this endpoint.

Path parameters

idstringRequired

Returns

200 OK

The Investment Control object.

Errors

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

400401403404409412413422424429500503

Request

curl -X GET 'https://api.dev.bank.corgi.com/investment-controls/{id}' \
  -H "Authorization: Bearer $TOKEN"

Response200

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