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

FieldTypeReqDescription
auctionDataobjectAuction house estimate and result data
comparablesarray[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
confidenceenumConfidence 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.
entityIdstringReference to the entity being valued — an Asset.id, Property.id, or AssetCollection.id
entityTypeenumThe 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).
fieldProvenancearray[Field provenance]Per-field provenance records — how each field's value was obtained
idstringUnique identifier for this valuation within the INHERIT document
methodenumThe 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.
notesstringFree-text notes about this valuation — methodology details, caveats, market conditions, or disagreements with other valuations
provenanceProvenanceConsolidated provenance metadata — how this entity was created, by whom, and whether a human has verified it
providerstringWho performed the valuation — the name of the person, firm, or service
providerTypeenumThe 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
valuationDatestringDate the valuation was performed or assessed
valuationPurposeenumThe 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.
valuedAmountMoneyThe valuation amount, in minor currency units
valuerRegistrationobjectThe 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).
high
medium
low
unknown

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.

asset
property
asset_collection

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).

comparable_sales
replacement_cost
income_approach
market_listing
insurance_schedule
ai_analysis
expert_opinion
other

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.

owner
professional_valuer
auction_house
dealer
insurance_assessor
tax_authority
ai_estimate
other

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.

current_estimate
date_of_death
insurance
official
tax_return
dealer_offer
ai_estimate
pre_sale
probate

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.

Get in touch

Have feedback on the schema reference? We'd love to hear from you.

Subject: Schema Reference Feedback