sp:Entitlement

https://publicschema.org/sp/Entitlement

candidate

An instance of a recognized right of a specific beneficiary to receive a benefit. Each entitlement typically corresponds to one disbursement period, but multiple entitlements may exist for the same enrollment and overlapping periods (e.g., base transfer plus top-up, multi-tranche payments, or emergency supplements). The entitlement references both the enrollment (who) and the benefit schedule (what was promised).

JSON-LD JSON Schema CSV Definition (Excel) Template (Excel)

Properties

Property	Type	Definition
Enrollment reference	`uri`	Reference to the enrollment to which this entitlement belongs.
Schedule reference	`uri`	Reference to the benefit schedule that this entitlement corresponds to.
Benefit modality	`string` (sp/benefit-modality)	The form of benefit the entitlement specifies (cash, voucher, in-kind, service, fee waiver).
Benefit description	`string`	A free-text description of the specific benefit.
Amount	`decimal`	The monetary or quantitative value of the item being delivered, owed, or redeemed, expressed as a decimal number in the associated currency.
Currency	`string` (currency)	The ISO 4217 currency code for a monetary value.
Coverage period start	`date`	The start date of the period this entitlement covers.
Coverage period end	`date`	The end date of the period this entitlement covers.
Entitlement status	`string` (sp/entitlement-status)	The lifecycle state of this entitlement instance.
Document expiry date	`date`	The date on which the document or credential representing the entitlement expires, which may differ from the entitlement period itself.

Evidence

Present in 5 of 6 mapped delivery systems.

Present in 5 of 6 mapped systems. EBSI PRC (Provisional Replacement Certificate for the European Health Insurance Card) informed the document_expiry_date property, distinguishing credential expiry from entitlement period.

Standard	Equivalent	Match
DCI IBR	Benefit	broad
DCI Benefit records what was delivered (type, value, date); PublicSchema Entitlement records the recognized right to receive. DCI has no equivalent of the promise-to-delivery separation, so entitled-but-not-yet-paid states cannot be represented

Referenced by this concept

Social and beneficiary registries Australian Government Department of Foreign Affairs and Trade (DFAT), 2017
EBSI PDA1 European Blockchain Services Infrastructure (EBSI), European Commission
FHIR FinancialResourceStatus Health Level Seven International (HL7)
DCI IBR Digital Convergence Initiative (DCI), 2024
WB SP Delivery Framework World Bank, 2024

See full reference catalogue