Run a valuation
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.
Idempotency-Key?stringOptional caller-generated retry key. Reusing the same key returns the saved valuation but never reveals its one-time claim token again.
^\S(?:[\s\S]*\S)?$8 <= length <= 200application/json- 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^(?:(?:\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])))$datecurrency?"USD"Value v1.16 currently accepts USD only. Other currencies must be converted before valuation.
"USD""USD"reference?ReferenceOptional caller-defined label returned as reference so the result can be matched to the caller's workflow.
1 <= length <= 200valuation_context?Optional purpose, standard, premise, transaction, ownership, and SBA lending context. Screening defaults apply when omitted.
{ "purpose": "screening", "standard": "unspecified", "premise": "going_concern", "transaction_type": "unspecified", "ownership_basis": "unspecified"}portfolio_adjustments?array<>Optional portfolio-level additions or deductions with provenance.
items <= 100[]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.
1 <= itemscombine_as_portfolio?CombineAsPortfolioRequired as true when items contains more than one entry, confirming that the entries should be valued together as one portfolio.
falsedata; revision when applicable; action_receipt; pending_approvals[]; warnings[]; validation_errors[].
application/json- response
schema_version*unknownvaluation_id*string^val_[0-9a-f]{32}$model_release*string^smb\.value\.engine\.v1\.17\.(?:0|[1-9][0-9]*)$length <= 200valuation_date*stringdatecurrency*string^[A-Z]{3}$reference*|nullscope?benchmark_snapshot_id*string^bm_[0-9a-f]{16}$portfolio*results*array<>1 <= itemsitem_count*integer1 <= valuelimitations*array<>result_hash*ResultHashSHA-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.
^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" }}