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.

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

TypeScript Definitions

Use the request body type in TypeScript.

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?string

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?string

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?boolean

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

Defaultfalse

Response Body

`application/json`

`application/problem+json`

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

Run a valuation

Header Parameters

Request Body

Response Body

200application/json

400application/problem+json

401application/problem+json

403application/problem+json

404application/problem+json

409application/problem+json

422application/problem+json

429application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`