Beta

Answer valuation questions

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
POST
/v1/valuations/{valuation_id}/answers

Answers immutable questions from one saved valuation, reruns the model from its persisted input snapshot, and saves an exact successor valuation linked to the selected predecessor attempt.

Authorization

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

Path Parameters

valuation_id*string

Stable valuation ID.

Match^val_[0-9a-f]{32}$

Header Parameters

Idempotency-Key*string
Match\S
Length8 <= length <= 200
SMB-Workspace-Id*string
Formatuuid

Request Body

application/json
  1. body
business_id*SmbV0OperationsGetBusinessComparablesRequestBusinessId

Stable SMB Business ID.

Match^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$
answers*array<>
Items1 <= items <= 64

Response Body

The existing resource or idempotent replay was returned.

application/json
  1. response
intake_id*string

Saved successor intake.

Match^vin_[0-7][0-9A-HJKMNP-TV-Z]{25}$
business_id*SmbV0OperationsGetBusinessComparablesRequestBusinessId

Stable SMB Business ID.

Match^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$
status*string
idempotent_replay*smb_v0_operations_create_list_request.__local.properties.body.__schema16
supersedes_valuation_id*string

Immediate predecessor valuation.

Match^val_[0-9a-f]{32}$
valuation_id*string

Saved successor valuation.

Match^val_[0-9a-f]{32}$
result*|
curl -X POST 'https://example.com/v1/valuations/string/answers' \  -H 'Idempotency-Key: stringst' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "business_id": "string",  "answers": [    {      "question_id": "string",      "value": null    }  ]}'
{  "intake_id": "string",  "business_id": "string",  "status": "completed",  "idempotent_replay": true,  "supersedes_valuation_id": "string",  "valuation_id": "string",  "result": {    "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"  }}