Get a bank securities lot by ID

GET/ledger/securities/lots/{id}

Verified non-API-key staff/service with ledger:securities:read required. Read a bank-owned lot with separate original trade and actual cash provenance. All mutations require verified authority even in local mode; customers and API keys are refused. Evidence JSON is strict and bounded at 5 MiB; complete responses are bounded at 16 MiB and never silently truncated.

Path parameters

idstringRequired

Returns

200 OK

The Bank Securities Lot 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/ledger/securities/lots/{id}' \
  -H "Authorization: Bearer $TOKEN"

Response200

{
  "accrued_to_date": "2026-09-17",
  "actual_proceeds_amount": 10000,
  "cash_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "disposal_cash_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "disposal_date": "2026-09-17",
  "disposal_execution_sha256": "string",
  "disposal_order_id": "string",
  "disposal_settlement_date": "2026-09-17",
  "disposal_settlement_sha256": "string",
  "disposal_trade_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "exceptions": [
    "string"
  ],
  "execution_sha256": "string",
  "external_account_reference": "string",
  "id": "string",
  "instrument": {
    "actor": "string",
    "content_sha256": "string",
    "created_at": "2026-09-17T14:30:00Z",
    "custody_account": {
      "bank_owned": false,
      "custodian_reference": "string",
      "enabled": false,
      "exclusive_core_instructions": false,
      "external_account_reference": "string",
      "key_id": "string",
      "legal_entity": "string",
      "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "no_third_party_lien": false,
      "observed_at": "2026-09-17T14:30:00Z",
      "onboarding": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "opening_inventory_empty": false,
      "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,
      "issue_date": "2026-09-17",
      "kind": "string",
      "maturity_date": "2026-09-17",
      "name": "string",
      "price_scale": 0,
      "program_id": "string",
      "terms": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "unit_basis": "string",
      "unit_increment": 0,
      "unit_scale": 0,
      "zero_coupon": false
    },
    "kind": "string",
    "program": {
      "authority": {
        "reference": "string",
        "sha256": "string"
      },
      "bridge_subject": "string",
      "broker_name": "string",
      "broker_reference": "string",
      "custodian_name": "string",
      "custodian_reference": "string",
      "custody_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "dealers": [
        {}
      ],
      "enabled": false,
      "evidence_keys": {},
      "legal_entity": "string",
      "master_cash_external_account_reference": "string",
      "master_cash_identity": {
        "reference": "string",
        "sha256": "string"
      },
      "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "max_order_amount": 10000,
      "policy": {
        "accounting_evidence": {},
        "accrual_convention": "string",
        "acquisition_fees": "string",
        "cash_rounding": "string",
        "classification": "string",
        "credit_evidence": {},
        "credit_method": "string",
        "recognition": "string",
        "tax_evidence": {},
        "tax_method": "string"
      },
      "provider": "string",
      "trading_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "valid_from": "2026-09-17",
      "valid_through": "2026-09-17"
    }
  },
  "latest_observation": {
    "accrued_income_amount": 10000,
    "as_of": "2026-09-17",
    "close_out_complete": false,
    "currency_code": "USD",
    "cusip": "string",
    "custodian_reference": "string",
    "encumbered_units": 0,
    "evidence": {
      "data": "string",
      "format": "string",
      "sha256": "string"
    },
    "external_account_reference": "string",
    "fair_value_amount": 10000,
    "key_id": "string",
    "legal_entity": "string",
    "lot_id": "string",
    "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "observed_at": "2026-09-17T14:30:00Z",
    "original_execution_sha256": "string",
    "original_settlement_sha256": "string",
    "price": 0,
    "price_basis": "string",
    "signature": "string",
    "units": 0,
    "valuation_basis": "string",
    "version": "string"
  },
  "latest_valuation": {
    "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",
    "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "posting_date": "2026-09-17",
    "request": {
      "inputs": {
        "credit_allowance_amount": 10000,
        "credit_evidence": {},
        "earnings_deferred_tax_asset_amount": 10000,
        "earnings_deferred_tax_liability_amount": 10000,
        "earnings_tax_valuation_allowance_amount": 10000,
        "intent_to_sell": false,
        "oci_deferred_tax_asset_amount": 10000,
        "oci_deferred_tax_liability_amount": 10000,
        "oci_tax_valuation_allowance_amount": 10000,
        "required_to_sell_before_recovery": false,
        "tax_basis_amount": 10000,
        "tax_evidence": {}
      },
      "lot_id": "string",
      "lot_revision": 0,
      "observation": {
        "accrued_income_amount": 10000,
        "as_of": "2026-09-17",
        "close_out_complete": false,
        "currency_code": "USD",
        "cusip": "string",
        "custodian_reference": "string",
        "encumbered_units": 0,
        "evidence": {},
        "external_account_reference": "string",
        "fair_value_amount": 10000,
        "key_id": "string",
        "legal_entity": "string",
        "lot_id": "string",
        "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "observed_at": "2026-09-17T14:30:00Z",
        "original_execution_sha256": "string",
        "original_settlement_sha256": "string",
        "price": 0,
        "price_basis": "string",
        "signature": "string",
        "units": 0,
        "valuation_basis": "string",
        "version": "string"
      },
      "rationale": "string"
    },
    "result": {
      "accrual_to_date": "2026-09-17",
      "amortized_cost_amount": 10000,
      "as_of": "2026-09-17",
      "credit_allowance_amount": 10000,
      "deferred_tax_asset_amount": 10000,
      "deferred_tax_liability_amount": 10000,
      "fair_value_adjustment_amount": 10000,
      "fair_value_amount": 10000,
      "net_oci_amount": 10000,
      "pretax_oci_amount": 10000,
      "tax_earnings_amount": 10000,
      "tax_oci_amount": 10000
    }
  },
  "legal_entity": "string",
  "original_cost_amount": 10000,
  "program": {
    "actor": "string",
    "content_sha256": "string",
    "created_at": "2026-09-17T14:30:00Z",
    "custody_account": {
      "bank_owned": false,
      "custodian_reference": "string",
      "enabled": false,
      "exclusive_core_instructions": false,
      "external_account_reference": "string",
      "key_id": "string",
      "legal_entity": "string",
      "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "no_third_party_lien": false,
      "observed_at": "2026-09-17T14:30:00Z",
      "onboarding": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "opening_inventory_empty": false,
      "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,
      "issue_date": "2026-09-17",
      "kind": "string",
      "maturity_date": "2026-09-17",
      "name": "string",
      "price_scale": 0,
      "program_id": "string",
      "terms": {
        "data": "string",
        "format": "string",
        "sha256": "string"
      },
      "unit_basis": "string",
      "unit_increment": 0,
      "unit_scale": 0,
      "zero_coupon": false
    },
    "kind": "string",
    "program": {
      "authority": {
        "reference": "string",
        "sha256": "string"
      },
      "bridge_subject": "string",
      "broker_name": "string",
      "broker_reference": "string",
      "custodian_name": "string",
      "custodian_reference": "string",
      "custody_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "dealers": [
        {}
      ],
      "enabled": false,
      "evidence_keys": {},
      "legal_entity": "string",
      "master_cash_external_account_reference": "string",
      "master_cash_identity": {
        "reference": "string",
        "sha256": "string"
      },
      "master_cash_ledger_account_id": "lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "max_order_amount": 10000,
      "policy": {
        "accounting_evidence": {},
        "accrual_convention": "string",
        "acquisition_fees": "string",
        "cash_rounding": "string",
        "classification": "string",
        "credit_evidence": {},
        "credit_method": "string",
        "recognition": "string",
        "tax_evidence": {},
        "tax_method": "string"
      },
      "provider": "string",
      "trading_agreement": {
        "reference": "string",
        "sha256": "string"
      },
      "valid_from": "2026-09-17",
      "valid_through": "2026-09-17"
    }
  },
  "purchase_order_id": "string",
  "redemption_id": "string",
  "reservation_revision": 0,
  "reserved_order_id": "string",
  "reserved_redemption_id": "string",
  "revision": 0,
  "schedule": {
    "convention": "string",
    "cost_amount": 10000,
    "face_amount": 10000,
    "maturity_date": "2026-09-17",
    "start_date": "2026-09-17"
  },
  "settlement_date": "2026-09-17",
  "settlement_sha256": "string",
  "status": "string",
  "trade_date": "2026-09-17",
  "trade_journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "units": 0
}