Valuation
A valuation of an estate asset, property, or asset collection. Supports multiple valuations per entity over time — owner estimates, professional valuations, AI analyses, dealer offers, and probate-agreed figures
A valuation of an estate asset, property, or asset collection. Supports multiple valuations per entity over time — owner estimates, professional valuations, AI analyses, dealer offers, and probate-agreed figures
Required fields
identityTypeentityIdvaluedAmountvaluationDate
Fields
| Field | Type | Req | Description |
|---|---|---|---|
| auctionData | object | Auction house estimate and result data | |
| comparables | array[Comparable] | Comparable items found on marketplaces — used to support the valuation. Agent-generated comparables should include matchScore for quantitative filtering and will accumulate humanVerdict feedback over time | |
| confidence | enum | Confidence level in this valuation high: strong evidential basis — professional valuation, multiple close comparables, or agreed with tax authority. medium: reasonable basis but some uncertainty — fewer comparables, older data, or owner estimate with domain knowledge. low: limited evidence — rough estimate, weak comparables, or unfamiliar category. unknown: confidence has not been assessed. | |
| entityId | string | Reference to the entity being valued — an Asset.id, Property.id, or AssetCollection.id | |
| entityType | enum | The type of entity being valued asset: a valuation of a single Asset. property: a valuation of a Property. asset_collection: a valuation of an AssetCollection as a whole (which may differ from the sum of individual asset valuations). | |
| fieldProvenance | array[Field provenance] | Per-field provenance records — how each field's value was obtained | |
| id | string | Unique identifier for this valuation within the INHERIT document | |
| method | enum | The valuation methodology used comparable_sales: based on recent sales of similar items — the most common method for personal property and real estate. replacement_cost: cost to replace the item with an equivalent — common for insurance valuations. income_approach: value based on income the asset generates (rental yield, dividend income) — common for investment properties and business interests. market_listing: value derived from current market listings for similar items. insurance_schedule: value stated on an existing insurance schedule or policy. ai_analysis: automated valuation using AI, machine learning, or algorithmic models. expert_opinion: professional judgement by a qualified expert without formal methodology. other: any other valuation method. | |
| notes | string | Free-text notes about this valuation — methodology details, caveats, market conditions, or disagreements with other valuations | |
| provenance | Provenance | Consolidated provenance metadata — how this entity was created, by whom, and whether a human has verified it | |
| provider | string | Who performed the valuation — the name of the person, firm, or service | |
| providerType | enum | The type of person or organisation that provided the valuation owner: the asset owner's own estimate. professional_valuer: a qualified valuer (RICS, ASA, IVSC-accredited). auction_house: valuation by an auction house (Bonhams, Christie's, Sotheby's). dealer: valuation by a specialist dealer. insurance_assessor: valuation for insurance purposes. tax_authority: valuation agreed with or imposed by a tax authority (HMRC, IRS). ai_estimate: automated valuation by an AI or algorithmic model. other: any other type of valuer. | |
| validUntil | [string null] | The date until which this valuation is considered valid. Common for insurance valuations which require annual renewal. After this date, the valuation may need to be refreshed | |
| valuationDate | string | Date the valuation was performed or assessed | |
| valuationPurpose | enum | The purpose for which this valuation was obtained current_estimate: a current market value estimate for planning purposes. date_of_death: valuation as at the date of death — required for IHT and estate tax. insurance: valuation for insurance cover (often replacement cost, which may exceed market value). official: valuation agreed with or imposed by an official body. tax_return: valuation for inclusion on a tax return. dealer_offer: a valuation implicit in a dealer's offer to purchase. ai_estimate: an automated estimate for initial triage and planning. pre_sale: valuation in anticipation of sale. probate: valuation submitted for and accepted by the probate court. | |
| valuedAmount | Money | The valuation amount, in minor currency units | |
| valuerRegistration | object | The professional body registration of the valuer. A valuation from a RICS-registered surveyor or ASA-accredited appraiser carries significantly more weight with tax authorities and probate courts Common professional bodies: RICS (Royal Institution of Chartered Surveyors, UK/global), ASA (American Society of Appraisers, US), IVSC (International Valuation Standards Council), AAA (Association of Accredited Appraisers), ISA (International Society of Appraisers). |
Before you get in touch
These resources may answer your question straight away.
Get in touch
Have feedback on the schema reference? We'd love to hear from you.
Subject: Schema Reference Feedback