Beta

Run a valuation

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
POST
/v1/valuations

Estimate what one business, asset, or portfolio is worth from the facts provided. The result includes persistence.status. When persistence completes, save the returned intake_id and one-time claim_token so the guest valuation can be attached to a Business after authentication. Idempotent replays intentionally omit the claim token.

Header Parameters

Idempotency-Key?string

Optional caller-generated retry key. Reusing the same key returns the saved valuation but never reveals its one-time claim token again.

Match^\S(?:[\s\S]*\S)?$
Length8 <= length <= 200

Request Body

application/json
  1. body

Identify an existing SMB Business or describe any business, real estate, equipment, brand, customer book, or mixed portfolio using only the facts available. SMB Value selects applicable methods and returns a compact result for every item plus a portfolio Bestimate, range, evidence support, missing information, and review flags.

valuation_date?ValuationDate
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
currency?"USD"

Value v1.16 currently accepts USD only. Other currencies must be converted before valuation.

Default"USD"
Value in"USD"
reference?Reference

Optional caller-defined label returned as reference so the result can be matched to the caller's workflow.

Length1 <= length <= 200
valuation_context?

Optional purpose, standard, premise, transaction, ownership, and SBA lending context. Screening defaults apply when omitted.

Default
{  "purpose": "screening",  "standard": "unspecified",  "premise": "going_concern",  "transaction_type": "unspecified",  "ownership_basis": "unspecified"}
portfolio_adjustments?array<>

Optional portfolio-level additions or deductions with provenance.

Itemsitems <= 100
Default[]
items*array<|>

One or more businesses or assets to value. There is no fixed item-count limit. The encoded request must be no larger than 8 MiB and Value rejects normalized workloads above 15,000 structural work units. Use business_id for a Business SMB already knows; otherwise send type and whatever details are available.

Items1 <= items
combine_as_portfolio?CombineAsPortfolio

Required as true when items contains more than one entry, confirming that the entries should be valued together as one portfolio.

Defaultfalse

Response Body

data; revision when applicable; action_receipt; pending_approvals[]; warnings[]; validation_errors[].

application/json
  1. response
schema_version*unknown
valuation_id*string
Match^val_[0-9a-f]{32}$
model_release*string
Match^smb\.value\.engine\.v1\.17\.(?:0|[1-9][0-9]*)$
Lengthlength <= 200
valuation_date*string
Formatdate
currency*string
Match^[A-Z]{3}$
reference*|null
scope?
benchmark_snapshot_id*string
Match^bm_[0-9a-f]{16}$
portfolio*
results*array<>
Items1 <= items
item_count*integer
Range1 <= value
limitations*array<>
result_hash*ResultHash

SHA-256 of the UTF-8 deterministic canonical JSON public result after API-owned question IDs are projected, with result_hash itself omitted. Object keys are sorted recursively and array order is preserved.

Match^sha256:[0-9a-f]{64}$
persistence*|

Best-effort guest persistence. A completed valuation can be claimed after authentication; an unavailable status does not invalidate the computed valuation result.

curl -X POST 'https://example.com/v1/valuations' \  -H 'Content-Type: application/json' \  -d '{  "reference": "owner-operated-hvac-business",  "valuation_context": {    "purpose": "sale_or_purchase",    "standard": "fair_market_value",    "premise": "going_concern",    "transaction_type": "asset_sale",    "ownership_basis": "controlling"  },  "items": [    {      "asset_id": "hvac-business",      "type": "business",      "name": "Sample HVAC Services",      "details": {        "naics_code": "238220",        "employee_count": 18,        "owner_operated": true,        "annual_revenue": 2800000,        "sde": 520000,        "ebitda": 410000,        "adjusted_assets": 310000,        "liabilities": 85000,        "stable_earnings": true,        "business_real_estate_earnings_basis": "not_applicable"      }    }  ]}'
{  "schema_version": "smb.value.result.v2",  "valuation_id": "string",  "model_release": "string",  "valuation_date": "2019-08-24",  "currency": "string",  "reference": "string",  "scope": {    "purpose": "screening",    "standard": "unspecified",    "premise": "going_concern",    "transaction_type": "unspecified",    "ownership_basis": "unspecified"  },  "benchmark_snapshot_id": "string",  "portfolio": {    "status": "valued",    "conclusion": {      "amount": 0,      "currency": "string",      "range": {        "low": 0,        "high": 0      },      "value_basis": "asset_value"    },    "evidence_strength": "insufficient",    "permitted_use": "withheld",    "analysis_maturity": "synthetic_screening",    "reconciliation_status": "not_available",    "material_gaps": [      {        "code": "string",        "affected_items": 1,        "message": "string"      }    ],    "next_questions": [      {        "question_id": "string",        "rank": 1,        "question": "string",        "improves": "subject_scope",        "why": "string",        "answer_paths": [          "valuation_context.lending_context.sba_loan_number_date"        ]      }    ],    "lending_readiness": {      "status": "not_requested",      "policy_reference": "string"    }  },  "results": [    {      "item_id": "string",      "type": "business",      "name": "string",      "status": "valued",      "conclusion": {        "amount": 0,        "currency": "string",        "range": {          "low": 0,          "high": 0        },        "value_basis": "asset_value"      },      "primary_methodology": {        "name": "string",        "family": "income",        "rationale_codes": [          "caller_selected_method"        ],        "rationale": "string"      },      "alternatives": [        {          "methodology": "string",          "indicated_value": 0,          "currency": "string",          "value_basis": "asset_value",          "status": "calculated",          "warning_codes": [            "insufficient_inputs"          ]        }      ],      "method_comparison": {        "methods_considered": 0,        "reconciliation_status": "not_available"      },      "evidence_summary": {        "evidence_strength": "insufficient",        "permitted_use": "withheld",        "analysis_maturity": "synthetic_screening",        "financials_status": "not_provided",        "selected_period": "2019-08-24",        "periods_supplied": 0,        "earnings_trend": "insufficient_history",        "input_fields_used": [          "annual_revenue"        ],        "benchmark_support": {          "resolution": "not_applicable",          "evidence_class": "observed",          "as_of": 0,          "geography": "string",          "source_families": [            "U.S. Census Bureau"          ]        }      },      "uncertainty": {        "range": {          "low": 0,          "high": 0        },        "label": "modeled_sensitivity_range",        "driver_categories": [          "operating_performance"        ]      },      "material_gaps": [        {          "code": "string",          "message": "string"        }      ],      "next_questions": [        {          "question_id": "string",          "rank": 1,          "question": "string",          "improves": "subject_scope",          "why": "string",          "answer_paths": [            "valuation_context.lending_context.sba_loan_number_date"          ]        }      ],      "lending_readiness": {        "status": "not_requested",        "policy_reference": "string"      }    }  ],  "item_count": 1,  "limitations": [    "string"  ],  "result_hash": "string",  "persistence": {    "intake_id": "string",    "claim_token": "string",    "status": "completed"  }}