A jurisdiction rule value with effective dates, legislative status, and change history

Required fields
valueeffectiveFromstatus

Fields

FieldTypeReqDescription
effectiveFromstringThe date from which this rule value takes effect. For enacted legislation, this is the commencement date, not the date of royal assent https://www.iso.org/iso-8601-date-and-time-format.html
effectiveUntilobjectThe date this rule value was or will be superseded. Null means it is currently in effect with no known end date null = no known end date (current rule). A date = superseded on that date — https://www.iso.org/iso-8601-date-and-time-format.html
jurisdictionJurisdictionThe jurisdiction this temporal rule applies to. Enables different thresholds for different jurisdictions (e.g. UK IHT vs Scottish IHT)
legislativeReferencestringCitation for the legislation that establishes this rule value. Include act name, section, and year e.g. 'Finance Act 2027 s.12', 'Swiss Civil Code Art. 471 (2023 revision)', 'Inheritance Tax Act 1984 s.7'
notesstringFree-text commentary on this rule value — transitional provisions, known ambiguities, or political context
predecessorValue[number boolean string object null]The previous value of this rule, for computing deltas and understanding the direction of change. Null if this is the first known value Same type flexibility as 'value', plus null for the first known value.
statusenumThe legislative status of this rule. Only 'enacted' rules are legally binding — all others are prospective enacted: in force and legally binding. royal_assent: passed by legislature but not yet commenced. bill_stage: currently progressing through parliament or congress. consultation: proposed rule under public consultation. announced: government has stated intent but no formal legislation exists.
value[number boolean string object]The actual rule value — a number (tax rate, threshold in minor units), boolean (rule applies or not), string (enum value, fraction), or object (complex rule). The consumer must interpret this in context JSON Schema 'number' includes integers. Do not add 'integer' separately — oneOf would fail because a value like 50 matches both.
enacted
royal_assent
bill_stage
consultation
announced

Get in touch

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

Subject: Schema Reference Feedback