Bequest

Required fields

idbequestType

Fields

Field	Type	Description
amount	Money	Cash amount for pecuniary and demonstrative bequests, in minor currency units
applicableLaw	Jurisdiction	The jurisdiction whose succession law governs this item. Missing means defaults to estate domicile
assetCollectionId	string	Reference to the AssetCollection.id being bequeathed. A bequest may reference either assetIds (individual items) or assetCollectionId (entire collection), not both
assetIds	array[string]	References to Asset.id(s) being bequeathed as individual items. A bequest may reference either assetIds (individual items) or assetCollectionId (entire collection), not both
beneficiaryId	string	Reference to the Person.id of the individual beneficiary
beneficiaryIdDisplay	string	Human-readable display name for the referenced beneficiary
beneficiaryOrganisation	Beneficiary organisation	Organisation receiving this bequest, if not an individual
bequestType	object	The category of bequest. Core types cover common law estates. Extension types use x-inherit- prefix (e.g. x-inherit-wasiyya, x-inherit-halachic-matanah) specific: a named item to a named person. pecuniary: fixed cash sum. demonstrative: cash from specified fund. general: from general estate. residuary: remainder. life_interest: right to use/benefit during lifetime. class: to a category of people. debt_forgiveness: cancellation of a debt owed to the testator.
charityGiftAidEligible	boolean	Whether the bequest has been verified as eligible for Gift Aid. In the UK, estates leaving 10%+ to charity qualify for the reduced 36% IHT rate
charityNonMergingClause	boolean	Whether the gift fails if the charity merges with another organisation before distribution
charityPurposeRestriction	string	Restriction on how the charity may use the bequeathed funds — e.g. 'Must be used for cancer research only'
charityRegistrationVerifiedAt	string	When the charity's registration was last verified as active
charityReportingRequired	boolean	Whether the charity is required to report back on how the funds were used
classDefinition	string	Natural-language definition of the beneficiary class. Required for class bequests. Must be precise enough for executors to identify all members Natural-language description of the class of beneficiaries (e.g. 'All my grandchildren living at my death').
classSubstitution	object	Substitution rules for class gifts — what happens when a member of the class predeceases the testator
clauseReference	string	The clause number in the will that contains this bequest
comments	array[object]	Discussion comments on this entity
conditions	array[object]	Conditions precedent that must be satisfied before the beneficiary receives this bequest. Each condition has a typed category for machine-readable common patterns, plus a human-readable description survival_period: beneficiary must survive the testator by a specified number of days (e.g. 30-day survivorship clause). age_attainment: beneficiary must reach a specified age. event: a specific event must occur (e.g. graduation, marriage). marriage: beneficiary must be married at the relevant date. residence: beneficiary must reside in a specified location. employment: beneficiary must be employed in a specified role or industry. custom: free-text condition not covered by other types — use description field
constrainedBy	enum	Which legal principle constrains this bequest, if any testamentary_freedom: testator may dispose of this gift freely. customary_rule: customary law constrains or overrides this bequest. forced_heirship: civil law forced heirship rules constrain this bequest. religious_rule: religious law constrains this bequest (e.g. wasiyya limited to one-third). coparcenary_survivorship: Hindu coparcenary property passes by survivorship, not by will.
customaryOverride	boolean	Whether customary or religious law overrides the testator's freedom to dispose of this gift as they wish Whether customary/religious law overrides testamentary freedom for this bequest.
description	string	Free-text description of the bequest — what is being given
distributionMethod	object	How the bequest is distributed among multiple beneficiaries per_capita: each beneficiary receives an equal share. per_stirpes: shares pass by representation. modified_per_stirpes: like per_stirpes but sharing begins at first generation with living members. per_capita_at_each_generation: shares at each generation divided equally among living members and descendants of deceased members.
executorDirections	array[object]	Administrative directions to the executor regarding this bequest
giftAidRegistrationNumber	string	Gift Aid registration number for the charity
giftAidVerificationUrl	string	URL to verify the Gift Aid registration
giftAidVerifiedAt	string	When Gift Aid registration was last verified
hotchpot	boolean	Whether lifetime gifts (advances) to the beneficiary are brought into account when calculating their share. Common in intestacy and some wills Whether lifetime gifts to the beneficiary should be brought into account when calculating their share.
hotchpotTransferIds	array[string]	References to lifetime transfer IDs that should be brought into account (hotchpot) when calculating this beneficiary's entitlement. Links bequests to prior gifts — if the testator gave the beneficiary £50,000 during their lifetime, this bequest may be reduced accordingly
id	string	Unique identifier for this bequest within the INHERIT document
inheritanceResponse	Inheritance response	The beneficiary's formal response to this inheritance, if applicable
insurancePolicyIds	array[string]	References to InsurancePolicy.id(s) associated with this bequest. Links life insurance or other policies whose proceeds form part of this gift
legacyPledge	object	A legacy pledge commitment tracked before the will is finalised
liabilityIds	array[string]	References to Liability.id(s) associated with this bequest. For debt_forgiveness bequests, these are the debts being cancelled. For other types, indicates liabilities attached to the bequeathed asset Enables structured debt forgiveness modelling (Phase 2) and asset-encumbrance tracking. A bequest of a mortgaged property should reference both the Property (via propertyIds) and the Liability (via liabilityIds)
lifeInterest	Life interest	Life interest details, required when type is 'life_interest'
mentionedAssetIds	array[string]	Assets mentioned in this clause for clarity but not limiting scope. For residuary bequests, named for legal certainty while absorbing all unallocated assets
mentionedPropertyIds	array[string]	Properties mentioned in this clause for clarity but not limiting scope
notes	string	Free-text notes about this bequest. Use for context, testator intent, or special instructions to executors
postDeathActions	array[Post death action]	Post-death actions that modified this bequest — disclaimers, deeds of variation, appropriations
powerOfAppointmentId	string	Reference to a PowerOfAppointment.id — indicates this bequest's distribution is subject to a power of appointment
precatoryWishes	array[object]	Non-binding wishes expressed by the testator about how the beneficiary should use or treat the bequeathed item
predeceaseRule	enum	What happens if the beneficiary dies before the testator lapse: gift fails if the beneficiary predeceases the testator — falls into the residuary estate. per_stirpes: passes to the predeceased beneficiary's issue by representation. substitution: passes to a named substitute beneficiary. accrual: redistributed among surviving co-beneficiaries of the same gift. statutory_default: the jurisdiction's default rule applies (e.g. s.33 Wills Act 1837 in England and Wales).
priority	integer	Explicit priority order within the will. Lower numbers take precedence
propertyIds	array[string]	References to Property.id(s) being devised. Links this bequest to specific real property — enables programmatic estate distribution calculation Connects bequests to the properties array. A specific devise of 'my house at 42 Elm Street' should reference the Property entity. Validated at Level 2 for referential integrity
provenance	Provenance	Consolidated provenance metadata — how this entity was created, by whom, and whether a human has verified it
sharePercentage	number	Percentage share of the residuary estate or a specified fund
sourceAssetId	string	Reference to the Asset.id from which a demonstrative bequest should be paid For demonstrative bequests — the asset from which the amount should be paid.
substitutions	array[Substitution]	Substitute beneficiaries in case the primary beneficiary cannot receive the gift
visibility	Visibility

testamentary_freedom

customary_rule

forced_heirship

religious_rule

coparcenary_survivorship

testamentary_freedom: testator may dispose of this gift freely. customary_rule: customary law constrains or overrides this bequest. forced_heirship: civil law forced heirship rules constrain this bequest. religious_rule: religious law constrains this bequest (e.g. wasiyya limited to one-third). coparcenary_survivorship: Hindu coparcenary property passes by survivorship, not by will.

lapse

per_stirpes

substitution

accrual

statutory_default

lapse: gift fails if the beneficiary predeceases the testator — falls into the residuary estate. per_stirpes: passes to the predeceased beneficiary's issue by representation. substitution: passes to a named substitute beneficiary. accrual: redistributed among surviving co-beneficiaries of the same gift. statutory_default: the jurisdiction's default rule applies (e.g. s.33 Wills Act 1837 in England and Wales).