Create a bank securities valuation

POST/ledger/securities/valuations

Fresh verified non-API-key staff with ledger:securities:write required. Requires the current lot revision, actual signed price with intraday or day_close basis and explicit independently evidenced tax basis, separate OCI/earnings deferred taxes, credit allowance and sale assessments. Unknown tax/credit is not zero. Ordinary marks refuse required write-down/new-basis branches that need a separate supported accounting resolution. 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.

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

inputsobjectRequired

AccountingInputs are explicit controller-supplied assessments, not inferred tax rates or a tax engine. Deferred tax effects are allocated separately to this lot's AFS OCI and earnings; current income tax is a separate tax source.

12 child attributes

credit_allowance_amountinteger or nullOptional

credit_evidenceobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

earnings_deferred_tax_asset_amountinteger or nullOptional

earnings_deferred_tax_liability_amountinteger or nullOptional

earnings_tax_valuation_allowance_amountinteger or nullOptional

intent_to_sellboolean or nullOptional

oci_deferred_tax_asset_amountinteger or nullOptional

oci_deferred_tax_liability_amountinteger or nullOptional

oci_tax_valuation_allowance_amountinteger or nullOptional

required_to_sell_before_recoveryboolean or nullOptional

tax_basis_amountinteger or nullOptional

tax_evidenceobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

lot_idstringRequired

lot_revisionintegerRequired

observationobjectRequired

23 child attributes

accrued_income_amountinteger or nullOptional

as_ofstring · dateRequired

A business date, YYYY-MM-DD

close_out_completebooleanRequired

currency_codestringRequired

cusipstringRequired

custodian_referencestringRequired

encumbered_unitsintegerRequired

evidenceobjectRequired

3 child attributes

datastring · byteRequired

formatstringRequired

sha256stringRequired

external_account_referencestringRequired

fair_value_amountinteger or nullOptional

Actual custody units at supplied price

key_idstringRequired

legal_entitystringRequired

lot_idstringRequired

master_cash_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

observed_atstring · date-timeRequired

original_execution_sha256stringRequired

original_settlement_sha256stringOptional

priceinteger or nullOptional

price_basisstringOptional

Optional actual bid/ask/mid/last source; repo requires bid

signaturestringRequired

unitsintegerRequired

Actual custodian quantity, distinct from trade-date book quantity

valuation_basisstringOptional

Intraday uses start of AsOf; day_close uses start of AsOf+1

versionstringRequired

rationalestringRequired

Returns

200 OK

The Bank Securities Valuation 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/ledger/securities/valuations' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "credit_allowance_amount": 10000,
      "credit_evidence": {
        "reference": "string",
        "sha256": "string"
      },
      "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": {
        "reference": "string",
        "sha256": "string"
      }
    },
    "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": {
        "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"
    },
    "rationale": "string"
  }'

Response200

{
  "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": {
        "reference": "string",
        "sha256": "string"
      },
      "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": {
        "reference": "string",
        "sha256": "string"
      }
    },
    "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": {
        "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"
    },
    "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
  }
}