A named group of related assets — e.g. a model railway collection, vinyl record library, or art portfolio. Lets families and dealers understand which items belong together and should be considered as a set

Required fields
idrootDocumentIdname

Fields

FieldTypeReqDescription
categoryenumThe primary category of items in this collection Broad category for the collection. Use 'other' for niche collections (e.g. vintage typewriters, fountain pens). Individual assets within the collection may have more specific categories.
descriptionstringContext for family members and dealers about the collection's scope, provenance, or significance
disposalHistoryarray[object]History of how items in this collection were disposed of during estate administration
disposalStrategyenumThe testator's preferred strategy for disposing of this collection. More structured than disposalWishes keep_together: collection should remain intact — bequeathed to one person or institution. sell_as_collection: sell as a single lot to one buyer. sell_individually: break up and sell items separately. auction: sell through an auction house. donate: donate to a museum, institution, or charity. gift_to_person: give to a specific named person. dealer_bids: use CherishedItems-style competitive dealer bidding. mixed: combination of approaches for different parts. undecided: testator has not decided.
disposalWishesstringFree-text guidance from the testator about what should happen to this collection — keep together, sell at auction, donate to a museum, etc
estimatedValueMoneyEstimated total value of the collection as a whole
idstringUnique identifier for this asset collection
imagesarray[Media]Overview photographs and videos of the collection as a whole — the display, the storage, the scale of the collection
mergedIntoobjectRecords that this entity was merged into another entity — the target entity is the canonical version
minimumAcceptableValueMoneyThe minimum total value the testator or executor will accept for the collection. Prevents fire-sale disposal. In minor currency units
namestringDisplay name for this collection
notesstringAny additional notes about this collection
preferredDisposalMethodenumPreferred channel for disposing of the collection private_sale: direct sale to a known buyer. auction_house: through an established auction house (Christie's, Bonhams, etc.). dealer_network: through specialist dealers in the collecting domain. online_marketplace: eBay, Catawiki, etc. specialist_fair: at a collecting fair or exhibition. museum_acquisition: sale or donation to a museum. other: any other method.
provenanceProvenanceConsolidated provenance metadata — how this entity was created, by whom, and whether a human has verified it
rootDocumentIdstringThe root document this entity belongs to — either an estate document (schema.json) or a catalogue document (catalogue.json)
specialistDealerNotesstringNotes about specialist dealers who might be interested in this collection. Names, contact details, areas of expertise
splitFromobjectProvenance record when this entity was created by splitting a larger entity. The original entity is typically archived after the split
valuationComparisonobjectComparison of different valuation sources for this collection — insurance, dealer, auction
valuationDatestringDate the valuation was performed or last updated
valuationSourceenumHow the estimated value was determined self_estimated = owner's own guess. dealer_valuation = assessed by a specialist dealer. auction_estimate = provided by an auction house. insurance_value = the insured replacement value.
model_railways
vinyl_records
art
jewellery
wine
stamps
coins
books
musical_instruments
fishing_gear
handbags
power_tools
watches
ceramics
memorabilia
other

Broad category for the collection. Use 'other' for niche collections (e.g. vintage typewriters, fountain pens). Individual assets within the collection may have more specific categories.

keep_together
sell_as_collection
sell_individually
auction
donate
gift_to_person
dealer_bids
mixed
undecided

keep_together: collection should remain intact — bequeathed to one person or institution. sell_as_collection: sell as a single lot to one buyer. sell_individually: break up and sell items separately. auction: sell through an auction house. donate: donate to a museum, institution, or charity. gift_to_person: give to a specific named person. dealer_bids: use CherishedItems-style competitive dealer bidding. mixed: combination of approaches for different parts. undecided: testator has not decided.

private_sale
auction_house
dealer_network
online_marketplace
specialist_fair
museum_acquisition
other

private_sale: direct sale to a known buyer. auction_house: through an established auction house (Christie's, Bonhams, etc.). dealer_network: through specialist dealers in the collecting domain. online_marketplace: eBay, Catawiki, etc. specialist_fair: at a collecting fair or exhibition. museum_acquisition: sale or donation to a museum. other: any other method.

self_estimated
dealer_valuation
auction_estimate
insurance_value

self_estimated = owner's own guess. dealer_valuation = assessed by a specialist dealer. auction_estimate = provided by an auction house. insurance_value = the insured replacement value.

Get in touch

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

Subject: Schema Reference Feedback