# PublicSchema

> Common definitions for public service delivery. An open, composable vocabulary of concepts and properties for public services. Think schema.org, but for public service delivery.

PublicSchema provides shared definitions so that programs serving the same people can coordinate, share data, and interoperate. It defines concepts (Person, Household, Enrollment, etc.), their properties, and controlled vocabularies with value-level mappings across 6 major systems (OpenSPP, openIMIS, DCI, DHIS2, FHIR R4, OpenCRVS).

Everything is optional and descriptive, not prescriptive. Systems adopt what they need.

## Concepts

- [Address](https://publicschema.org/Address): A structured physical or postal location used to reach a person, household, or organization. Addresses combine spatial and administrative components such as street, settlement, district, and postal code.

- [Adoption](https://publicschema.org/crvs/Adoption): A legal act by which one or more persons acquire the status of parent to a child, creating a parent-child relationship that did not previously exist in law. Distinguishes full adoption (where prior biological filiation is replaced) from simple adoption (where it is preserved alongside the new bond), following civil-law traditions and the Hague Convention on Intercountry Adoption.

- [Annulment](https://publicschema.org/crvs/Annulment): A judicial declaration that a marriage was invalid from its inception, typically because a legal impediment existed at the time of the ceremony (such as lack of consent, existing marriage, or prohibited degree of kinship). Distinct from Divorce, which ends a valid marriage.

- [AssessmentEvent](https://publicschema.org/sp/AssessmentEvent): A discrete event where a subject's data is processed through a specific assessment framework to generate a welfare profile or score. Triggers include initial registration, recertification, and shock-response reassessment.

- [AssessmentFramework](https://publicschema.org/sp/AssessmentFramework): A persistent set of rules, formulas, or criteria used to process subject data into a welfare profile or score. Assessment frameworks include proxy means tests, community scorecards, and composite welfare indices.

- [BenefitSchedule](https://publicschema.org/sp/BenefitSchedule): A program-level definition of a benefit stream that specifies the modality, amount, frequency, and time period over which benefits are provided. A program may have one or more benefit schedules (e.g., a monthly cash transfer and an annual school supplies kit).

- [Birth](https://publicschema.org/crvs/Birth): A live birth, meaning the complete expulsion or extraction of a product of conception from its mother, irrespective of duration of pregnancy, which after such separation breathes or shows any other evidence of life. Captures the child, the parents, and attributes used by civil registration and vital statistics (sex at birth, birth order, attendant, weight, place type).

- [Certificate](https://publicschema.org/crvs/Certificate): A document issued from a civil status record or vital event that attests to the event for external use. Distinct from the underlying record: certificates can be issued repeatedly, in different formats (full copy, extract, multilingual extract under ICCS/CIEC conventions), and by different offices (for example, an embassy issuing an extract of a record held in the country of origin).

- [CivilStatusAnnotation](https://publicschema.org/crvs/CivilStatusAnnotation): A marginal annotation (mention marginale) added to a civil status record to reflect a later vital event or administrative change. Examples include a marriage noted on the birth record of a spouse, a divorce noted on a marriage record, or a court-ordered correction. The annotation mechanism is how civil-law registries maintain a coherent civil identity over time without rewriting the original acte.

- [CivilStatusRecord](https://publicschema.org/crvs/CivilStatusRecord): The official written record (acte) held by a civil registration authority that attests to a vital event. In civil-law traditions, this is the persistent legal document that accumulates marginal annotations over time and from which certificates are issued. Distinct from the vital event itself (the underlying occurrence) and from certificates (the documents produced from the record on demand).

- [CRVSPerson](https://publicschema.org/crvs/CRVSPerson): A temporal snapshot of a Person as observed at the time of a vital event. Carries the same demographic properties as Person, but frozen at event time rather than reflecting current values. Used wherever a vital event needs to record who a person was (occupation, residence, education, etc.) at the moment the event occurred.

- [Death](https://publicschema.org/crvs/Death): The permanent disappearance of all evidence of life at any time after a live birth has taken place. Captures the deceased person, the cause and manner of death, the method used to ascertain cause, and the medical certifier. Aligned with the WHO definition and the ICD structure for cause-of-death classification.

- [DeliveryItem](https://publicschema.org/DeliveryItem): A line item describing a specific commodity and quantity within a delivery or voucher. Used to represent food baskets, supply kits, and other composite benefits where multiple commodities are included at specified quantities.

- [Divorce](https://publicschema.org/crvs/Divorce): The dissolution of a valid marriage by judicial or administrative decree. Distinct from Annulment, which declares the marriage invalid from the outset.

- [EligibilityDecision](https://publicschema.org/sp/EligibilityDecision): A formal determination of whether a subject meets a program's criteria based on assessed conditions. One assessment event can produce multiple eligibility decisions for different programs.

- [Enrollment](https://publicschema.org/sp/Enrollment): The administrative process of registering an eligible person or household as an active beneficiary of a program. Budget constraints and capacity limits mean that eligibility does not guarantee enrollment.

- [Entitlement](https://publicschema.org/sp/Entitlement): 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).

- [Event](https://publicschema.org/Event): Something that happens at a specific time or over a bounded period within a delivery system. Event is the shared supertype for records that capture occurrences (assessments, decisions, payments, deliveries, referrals, etc.), as distinct from standing entities like persons, groups, or programs.

- [FamilyRegister](https://publicschema.org/crvs/FamilyRegister): A record that tracks a family unit over time, centered on a head of household. Members are reached through the linked Family, which exposes GroupMembership entries for each person with their role (head, spouse, child, etc.) and entry or exit dates. Distinct from the event-based acte tradition: family registers (koseki in Japan, hukou in China, livret de famille in France) maintain a running view of the family as vital events occur. Status captures whether the register is active, closed, split, or merged.

- [Family](https://publicschema.org/Family): A social unit defined by kinship, marriage, or adoption, regardless of shared budget or co-residence. A family can span multiple households and geographic boundaries.

- [Farm](https://publicschema.org/Farm): An organizational and operating unit of agricultural production under single management. Farm records appear across agricultural registries, land administration, social protection, and climate adaptation programs.

- [FetalDeath](https://publicschema.org/crvs/FetalDeath): Death prior to the complete expulsion or extraction of a product of conception from its mother, irrespective of the duration of pregnancy. Distinct from live Birth followed by Death, and from miscarriages below viability thresholds set by national law. Captures gestational age, weight, and coded cause of fetal death using ICD-PM where available.

- [GeographicArea](https://publicschema.org/GeographicArea): A defined geographic region described by boundary geometry, administrative codes, or named locations. Used to specify the spatial extent of alerts, program coverage, and other location-bounded concepts.

- [Grievance](https://publicschema.org/sp/Grievance): A record of a beneficiary's or applicant's formal expression of dissatisfaction or dispute regarding any aspect of the delivery chain. Grievance covers appeals (requests to reverse a decision) and complaints (dissatisfaction with service quality).

- [GroupMembership](https://publicschema.org/GroupMembership): The link between a Person and a Group, carrying the role the person plays within that group (such as head, spouse, or dependent). This link allows a person to belong to multiple groups at the same time.

- [Group](https://publicschema.org/Group): An abstract collection of persons that serves as the base for concrete group types such as Household, Family, and Farm. Groups are linked to their members via membership links.

- [HazardEvent](https://publicschema.org/HazardEvent): An event or condition that may disrupt the delivery of public services or affect the well-being of a population. Covers natural hazards (floods, droughts, earthquakes), health emergencies, conflict, and economic shocks. Aligned with the Sendai Framework's broad definition of hazard, and mappable to OASIS CAP v1.2 for alert interoperability.

- [Household](https://publicschema.org/Household): A social and economic unit of one or more persons who share food and other essentials for living. The operational definition varies across countries and programs, combining criteria of co-residence, shared budget, shared cooking, kinship, and administrative registration.

- [Identifier](https://publicschema.org/Identifier): A unique alphanumeric code assigned to a party (person or group) by a system or authority, such as a national ID number, birth certificate number, household registration number, or program-assigned beneficiary code.

- [InKindDelivery](https://publicschema.org/InKindDelivery): A record of a direct physical distribution of goods or services from a program to a beneficiary, with no financial instrument involved. Covers food distribution, supply kits, agricultural inputs, school feeding, and direct service provision. Multiple in-kind deliveries may fulfill a single entitlement.

- [Legitimation](https://publicschema.org/crvs/Legitimation): The act by which a child previously born outside marriage acquires the legal status of a child born within marriage, typically following the subsequent marriage of the biological parents. Relevant in jurisdictions where the status of the child still varies by marital context.

- [Location](https://publicschema.org/Location): A named geographic or administrative area, such as a region, district, commune, or village. Location captures where a household or event is situated within an administrative hierarchy, distinct from a street address.

- [MarriageTermination](https://publicschema.org/crvs/MarriageTermination): The legal end of a marriage while both parties are alive. Abstract supertype grouping Divorce (dissolution of a valid marriage) and Annulment (declaration that the marriage was invalid from the outset). Death of a spouse ends the marriage but is recorded as a Death, not a MarriageTermination.

- [Marriage](https://publicschema.org/crvs/Marriage): The legal union of two persons under the applicable law. Captures the two parties, witnesses, and the type of marriage (civil, religious, customary, common law). Treated as a vital event rather than a standing relationship, since what is being registered is the occurrence that creates legal spousal status.

- [Parent](https://publicschema.org/crvs/Parent): A link entity that associates a Person with a parental role (biological mother, biological father, legal mother, legal father, adoptive mother, adoptive father, surrogate mother). Used on Birth, Adoption, PaternityRecognition, and Legitimation so that biological and legal parentage can be captured explicitly rather than collapsed into a single parent slot. Parallel in structure to GroupMembership.

- [Party](https://publicschema.org/Party): A person or organized group of persons that can be identified, enrolled in programs, and receive benefits or services. Party is the shared supertype for Person and Group, enabling references that accept either.

- [PaternityRecognition](https://publicschema.org/crvs/PaternityRecognition): A formal act in which a parent, typically a father, establishes legal parentage for a child born outside marriage. Takes place before a registrar, notary, or court and is often annotated on the child's original birth record. Distinct from Legitimation, which additionally establishes the child as born within marriage.

- [PaymentEvent](https://publicschema.org/PaymentEvent): A record of a direct monetary transfer from a program to a beneficiary. Covers bank transfer, mobile money, cash, agent network, and prepaid card channels. Multiple payment events may fulfill a single entitlement (e.g., split payments, multi-tranche disbursements, or retries after failure).

- [Person](https://publicschema.org/Person): The unique individual human being who is a subject of record within a social protection system. Person is the persistent, indivisible unit of identity in registries; operational statuses such as Registrant, Applicant, or Beneficiary are transient roles defined by the person's relationship to a specific Program, not properties of the person themselves.

- [Program](https://publicschema.org/sp/Program): A government or institutional social protection intervention that provides benefits to eligible individuals or households based on defined criteria. A program has a name, implementing agency, targeting approach, and coverage area.

- [Referral](https://publicschema.org/sp/Referral): A structured process of linking a subject to an external program, service, or provider to address identified needs. Referrals span a spectrum from passive information sharing to active service linkage with follow-up.

- [Relationship](https://publicschema.org/Relationship): A link defining the social, legal, or administrative connection between an individual and another person or group. Three broad types exist: kinship (biological or legal ties), administrative (grantee, caregiver, payment proxy), and economic (dependent, survivor).

- [VitalEvent](https://publicschema.org/crvs/VitalEvent): An event of legal and statistical importance that marks a change in a person's civil status, such as birth, death, fetal death, marriage, divorce, annulment, adoption, paternity recognition, or legitimation. VitalEvent is an abstract supertype that groups shared properties (when and where the event occurred, who registered it, and the registration lifecycle). Aligned with the UN Principles and Recommendations for Vital Statistics.

- [VoucherRedemption](https://publicschema.org/VoucherRedemption): A record of a single redemption transaction against a voucher. Each VoucherRedemption captures one visit to a vendor or agent where part or all of a voucher's value or entitled commodities were collected. For single-use vouchers, there is one VoucherRedemption. For incremental redemption (common in WFP value voucher programs), multiple VoucherRedemption records track each visit.

- [Voucher](https://publicschema.org/Voucher): A redeemable instrument issued to a beneficiary as fulfillment of a benefit entitlement. A voucher has a distinct lifecycle: creation, issuance, redemption, expiry, or cancellation. It may be electronic (digital code, SMS, QR) or paper. Multiple vouchers may fulfill a single entitlement, and a voucher's face value may differ from the entitlement amount.


## Properties

- [address](https://publicschema.org/address): The physical or postal address associated with this household.
- [address_area](https://publicschema.org/address_area): The name of a geographic area such as a neighborhood, quarter, or ward that groups addresses below the city level.
- [administrative_area](https://publicschema.org/administrative_area): The first-level administrative subdivision (province, state, region) containing the address.
- [administrative_level](https://publicschema.org/administrative_level): The numeric tier in the administrative hierarchy, following the OCHA COD-AB convention: 0 = country, 1 = first subnational (state, province, region), 2 = second subnational (district, county, department), and so on. No fixed maximum depth.
- [adoptee](https://publicschema.org/crvs/adoptee): The person being adopted in an adoption event. Typically a minor, but adult adoption exists in some jurisdictions.
- [adoption_type](https://publicschema.org/crvs/adoption_type): Whether the adoption is full (biological filiation is entirely replaced) or simple (biological filiation is preserved alongside the new parental link). Key distinction in civil-law traditions.
- [adoptive_parents](https://publicschema.org/crvs/adoptive_parents): The parents who acquire parental rights through the adoption, each captured as a Parent link entity with an adoptive role.
- [affected_locations](https://publicschema.org/affected_locations): The geographic or administrative areas affected by this event.
- [affected_programs](https://publicschema.org/affected_programs): Programs whose operations or beneficiaries are affected by this event.
- [age_at_event](https://publicschema.org/crvs/age_at_event): The stated age of the person at the time of the vital event. Used in low-completeness settings where date of birth is unknown and stated age is the only age data available.
- [altitude_max](https://publicschema.org/altitude_max): The maximum altitude of the area, in meters above sea level (WGS84 datum).
- [altitude_min](https://publicschema.org/altitude_min): The minimum altitude of the area, in meters above sea level (WGS84 datum).
- [amount](https://publicschema.org/amount): The monetary or quantitative value.
- [annotating_authority](https://publicschema.org/crvs/annotating_authority): The civil registration office that added the annotation to the record. May differ from the office that issued the original record if the person has moved.
- [annotation_date](https://publicschema.org/crvs/annotation_date): The date on which the annotation was added to the civil status record. Typically after the originating record was created, reflecting a later vital event.
- [annotation_text](https://publicschema.org/crvs/annotation_text): The full text of the marginal annotation as recorded on the civil status record. Preserves the exact wording used by the registration authority.
- [annotation_type](https://publicschema.org/crvs/annotation_type): The category of annotation: a court-ordered correction, a nationality change, or similar administrative modifications to the record's meaning.
- [annotations](https://publicschema.org/crvs/annotations): Marginal annotations (mentions marginales) added to a civil status record over time as subsequent vital events occur, such as a marriage noted on a birth record.
- [applicant](https://publicschema.org/applicant): The person or group that applied for and received this eligibility decision.
- [area_description](https://publicschema.org/area_description): A human-readable description of the geographic area, such as a region name or administrative boundary label.
- [assessed_entity](https://publicschema.org/sp/assessed_entity): Reference to the person or group that was assessed.
- [assessment_date](https://publicschema.org/assessment_date): The date on which the assessment was conducted.
- [assessor](https://publicschema.org/sp/assessor): The name or identifier of the field officer or system that conducted the assessment.
- [attendant_at_birth](https://publicschema.org/crvs/attendant_at_birth): The type of person who attended the delivery (physician, midwife, nurse, traditional birth attendant, other, or none). Used as a proxy for safe delivery in health statistics.
- [beneficiary](https://publicschema.org/beneficiary): The person or group enrolled in the program.
- [benefit_description](https://publicschema.org/sp/benefit_description): A free-text description of the specific benefit.
- [benefit_modality](https://publicschema.org/sp/benefit_modality): The form of benefit the entitlement specifies (cash, voucher, in-kind, service, fee waiver).
- [birth_order](https://publicschema.org/crvs/birth_order): For multiple births, the sequence number of this infant among the siblings born in the same delivery (1 for first-born, 2 for second-born, etc.).
- [birth_ref](https://publicschema.org/crvs/birth_ref): A reference to the Birth record of the child whose parentage is being recognized, legitimized, or otherwise modified. Links the current event back to the original birth record.
- [birth_type](https://publicschema.org/crvs/birth_type): Whether the birth was single, twin, triplet, or higher-order multiple. Captured at the level of the delivery, not per infant.
- [building_name](https://publicschema.org/building_name): The name of a building, estate, or compound, used in contexts where locations are identified by name rather than street number.
- [cause_of_death](https://publicschema.org/crvs/cause_of_death): A free-text description of the underlying cause of death as stated on the death certificate. Captured alongside a coded cause_of_death_code when classification is available.
- [cause_of_death_code](https://publicschema.org/crvs/cause_of_death_code): The coded underlying cause of death, typically an ICD-10 or ICD-11 code. The coding scheme in use is specified by cause_of_death_coding_system.
- [cause_of_death_coding_system](https://publicschema.org/crvs/cause_of_death_coding_system): The classification system used to code the cause of death (for example ICD-10, ICD-11, or a national variant). Required when comparing coded causes across jurisdictions.
- [cause_of_death_method](https://publicschema.org/crvs/cause_of_death_method): The method used to ascertain the cause of death: physician certified, verbal autopsy, coroner, lay reporting, or other. Important for judging data quality, since verbal autopsy and lay reporting are less precise than physician certification.
- [cause_of_fetal_death](https://publicschema.org/crvs/cause_of_fetal_death): A free-text description of the cause of a fetal death. Captured alongside cause_of_fetal_death_code when an ICD-PM or equivalent code is assigned.
- [cause_of_fetal_death_code](https://publicschema.org/crvs/cause_of_fetal_death_code): The coded cause of a fetal death, typically an ICD-PM (Perinatal Mortality) code. The coding system is specified by cause_of_fetal_death_coding_system.
- [cause_of_fetal_death_coding_system](https://publicschema.org/crvs/cause_of_fetal_death_coding_system): The classification system used to code the cause of a fetal death (for example ICD-PM, ICD-10, or a national variant).
- [certainty](https://publicschema.org/certainty): The confidence that the event has occurred or will occur.
- [certificate_document_type](https://publicschema.org/crvs/certificate_document_type): The type of event the certificate attests to (birth, death, marriage, divorce, adoption). Describes what the document is about, orthogonal to its format.
- [certificate_format](https://publicschema.org/crvs/certificate_format): The format of the certificate: full copy (reproducing the acte including marginal annotations), extract (summary only), or a multilingual extract for international use.
- [certificate_number](https://publicschema.org/crvs/certificate_number): The number printed on the issued certificate. Distinct from the registration number of the underlying event or record, since multiple certificates can be issued from the same record over time.
- [child](https://publicschema.org/crvs/child): The child whose birth, adoption, or legitimation is recorded in this event.
- [city](https://publicschema.org/city): The city, town, or village component of the address.
- [civil_status_record](https://publicschema.org/crvs/civil_status_record): A reference to a CivilStatusRecord. Used on annotations to point to the record being annotated, and on certificates to point to the record from which the certificate is issued.
- [commodity_type](https://publicschema.org/commodity_type): The type of commodity or goods being delivered or redeemable.
- [complainant](https://publicschema.org/sp/complainant): The person who submitted the grievance. The complainant need not be the enrolled beneficiary; community members, rejected applicants, or caretakers may also file grievances.
- [conditionality_type](https://publicschema.org/sp/conditionality_type): Whether the program requires beneficiaries to meet behavioral conditions to receive benefits (unconditional, conditional, soft conditional, labelled).
- [country](https://publicschema.org/country): The country, expressed as an ISO 3166-1 alpha-2 code where possible.
- [country_of_birth](https://publicschema.org/country_of_birth): The country where the person was born, expressed as an ISO 3166-1 code.
- [court](https://publicschema.org/crvs/court): The court that issued the judgment for a divorce, annulment, adoption, paternity recognition, or other court-ordered vital event.
- [coverage_area](https://publicschema.org/sp/coverage_area): The geographic or administrative scope of program coverage.
- [coverage_period_end](https://publicschema.org/sp/coverage_period_end): The end date of the period this entitlement covers.
- [coverage_period_start](https://publicschema.org/sp/coverage_period_start): The start date of the period this entitlement covers.
- [creation_date](https://publicschema.org/crvs/creation_date): The date on which the family register was created, typically at marriage, at the birth of the first child, or when a new household is administratively constituted.
- [currency](https://publicschema.org/currency): The ISO 4217 currency code for a monetary value.
- [cutoff_score](https://publicschema.org/sp/cutoff_score): The threshold score below or above which an applicant is considered eligible.
- [data_sources](https://publicschema.org/data_sources): The administrative, survey, or collected data sources that feed into the assessment calculation.
- [date_of_birth](https://publicschema.org/date_of_birth): The date on which the person was born.
- [date_of_death](https://publicschema.org/date_of_death): The date on which the person died.
- [deceased](https://publicschema.org/crvs/deceased): The person whose death is recorded. Remains a Person entity so that existing identifiers and attributes can still be referenced after death.
- [decision_basis](https://publicschema.org/decision_basis): The assessment event, score, or administrative rule that formed the basis for the decision.
- [decision_date](https://publicschema.org/decision_date): The date on which the eligibility decision was recorded.
- [delivery_channel](https://publicschema.org/delivery_channel): The mechanism through which the transfer reaches the beneficiary.
- [delivery_date](https://publicschema.org/delivery_date): The date on which the goods or services were distributed to the beneficiary.
- [delivery_location](https://publicschema.org/delivery_location): The location where the distribution took place, such as a distribution point, school, or health facility.
- [delivery_status](https://publicschema.org/delivery_status): The status of this in-kind delivery.
- [description](https://publicschema.org/description): A free-text summary describing the event, situation, or record.
- [document_expiry_date](https://publicschema.org/sp/document_expiry_date): The date on which the document or credential representing the entitlement expires, which may differ from the entitlement period itself.
- [domicile](https://publicschema.org/domicile): The place that the person treats as their permanent home, which may differ from the address of their current household.
- [dwelling_type](https://publicschema.org/dwelling_type): The type of dwelling occupied by the household (e.g., permanent structure, temporary shelter, shared housing).
- [education_level](https://publicschema.org/education_level): The highest level of formal education completed by a person.
- [eligibility_decision_ref](https://publicschema.org/sp/eligibility_decision_ref): Reference to the eligibility decision that authorized this enrollment.
- [eligibility_status](https://publicschema.org/eligibility_status): The outcome of the eligibility determination.
- [email_address](https://publicschema.org/email_address): An email address through which the person can be contacted.
- [employment_status](https://publicschema.org/employment_status): The labour force participation status of the person: whether they are employed, unemployed, or outside the labour force.
- [end_date](https://publicschema.org/end_date): The date on which this ceased to be effective.
- [enrollment_date](https://publicschema.org/enrollment_date): The date on which the enrollment became active and benefit delivery was authorized.
- [enrollment_ref](https://publicschema.org/enrollment_ref): Reference to the enrollment to which this entitlement belongs.
- [enrollment_status](https://publicschema.org/enrollment_status): The current lifecycle state of the enrollment.
- [entitlement_ref](https://publicschema.org/entitlement_ref): Reference to the entitlement that this payment or voucher fulfills.
- [entitlement_status](https://publicschema.org/sp/entitlement_status): The lifecycle state of this entitlement instance.
- [ethnic_group](https://publicschema.org/ethnic_group): The ethnic or cultural group of the person, as self-identified. The UNSD recommends nationally defined categories based on self-identification; no international classification exists.
- [event_date](https://publicschema.org/crvs/event_date): The date on which the vital event (birth, death, marriage, etc.) occurred. Distinct from the registration date, which is when the event was recorded by a registration authority.
- [event_date_estimated](https://publicschema.org/crvs/event_date_estimated): Whether the event date is an estimate rather than a known exact date. Common for late-registered births or deaths where the precise date is not documented.
- [event_location](https://publicschema.org/crvs/event_location): The specific place where the vital event occurred (for example, the hospital of birth or the place of death). Distinct from the registration location, which is where the event was recorded.
- [exit_date](https://publicschema.org/exit_date): The date the enrollment ceased to be active, whether through closure or graduation. Does not apply to temporary suspension.
- [exit_reason](https://publicschema.org/exit_reason): The reason the enrollment was permanently closed. Applies when enrollment status is closed, not when graduated.
- [expiry_date](https://publicschema.org/expiry_date): The date on which this record or document expires or becomes invalid.
- [failure_reason](https://publicschema.org/failure_reason): A description of why the payment failed, was returned, or was rejected.
- [family](https://publicschema.org/crvs/family): The family group tracked by a family register. Modeled as a Group so that household-level and family-level concepts can share structure.
- [family_name](https://publicschema.org/family_name): The family (last) name or surname of the person.
- [family_name_at_birth](https://publicschema.org/family_name_at_birth): The family name of the person at the time of birth, before any change due to marriage or other legal event.
- [family_register_status](https://publicschema.org/crvs/family_register_status): The lifecycle status of the family register: active, closed, split into multiple registers, or merged with another. Tracks how vital events reshape the register over time.
- [farm_area_hectares](https://publicschema.org/farm_area_hectares): The total area of the farm in hectares.
- [formation_date](https://publicschema.org/formation_date): The date on which this group was formed or registered.
- [framework_used](https://publicschema.org/sp/framework_used): Reference to the assessment framework used in this assessment event.
- [frequency](https://publicschema.org/frequency): How often the entitlement is delivered (monthly, quarterly, annual, one-time).
- [frequency_rule](https://publicschema.org/frequency_rule): An iCalendar recurrence rule (RFC 5545 RRULE) specifying a custom schedule. Used when the frequency property is set to 'custom'.
- [full_address](https://publicschema.org/full_address): The complete address written as a single text string. Coexists with structured address components for systems that store addresses as free text.
- [gender](https://publicschema.org/gender): The gender of the person as recorded in a social protection registry or identity document.
- [geocodes](https://publicschema.org/geocodes): Administrative or statistical codes that identify this area within a coding system (FIPS, P-code, postal code, etc.).
- [geometry](https://publicschema.org/geometry): The geographic boundary or shape, expressed as a GeoJSON Geometry object (Point, Polygon, MultiPolygon, etc.).
- [gestational_age](https://publicschema.org/crvs/gestational_age): The completed weeks of gestation at the time of the event. Used for fetal death and birth records to distinguish viability and to apply the ICD-PM mortality classification.
- [given_name](https://publicschema.org/given_name): The given (first) name of the person.
- [given_name_at_birth](https://publicschema.org/given_name_at_birth): The given name of the person at the time of birth, before any legal name change.
- [governing_jurisdiction](https://publicschema.org/sp/governing_jurisdiction): The country or subdivision whose legislation governs this enrollment. Implicit in domestic programs, but must be explicit in cross-border or federated contexts such as social security coordination between countries.
- [grievance_status](https://publicschema.org/sp/grievance_status): The current processing state of the grievance.
- [grievance_subject](https://publicschema.org/sp/grievance_subject): Reference to the person, enrollment, or payment event that the grievance concerns.
- [grievance_type](https://publicschema.org/sp/grievance_type): The category of grievance or complaint, classifying the nature of the issue raised.
- [group](https://publicschema.org/group): The group to which the person belongs.
- [group_memberships](https://publicschema.org/group_memberships): Group memberships held by this person, linking them to households, families, or other groups.
- [group_type](https://publicschema.org/group_type): The administrative or social category of the group.
- [hazard_type](https://publicschema.org/hazard_type): The category of hazard or disruptive event.
- [head_of_household](https://publicschema.org/crvs/head_of_household): The person designated as head of the family register, around whom the register is organized. Terminology and legal significance vary (koseki hittosha in Japan, hu zhu in China, chef de famille in French-inspired systems).
- [house_number](https://publicschema.org/house_number): The house, building, or plot number within a street or road.
- [identifier_scheme_id](https://publicschema.org/identifier_scheme_id): A URI or code that identifies the scheme or system under which the identifier was assigned.
- [identifier_scheme_name](https://publicschema.org/identifier_scheme_name): The human-readable name of the identifier scheme, such as 'National Identity Number' or 'Social Security Number'.
- [identifier_type](https://publicschema.org/identifier_type): The category of identifier document or number.
- [identifier_value](https://publicschema.org/identifier_value): The alphanumeric value of the identifier as issued or recorded.
- [identifiers](https://publicschema.org/identifiers): Unique identifiers assigned to this person or group (national ID, program ID, etc.).
- [implementing_agency](https://publicschema.org/sp/implementing_agency): The government ministry or organization responsible for program administration.
- [income_source](https://publicschema.org/income_source): The primary reported source of income for the household, used in targeting and proxy means testing.
- [industry](https://publicschema.org/industry): The branch of economic activity in which the person works, classified according to the International Standard Industrial Classification (ISIC Rev.4). Too large to enumerate; countries use national adaptations.
- [informant](https://publicschema.org/crvs/informant): The person who declares the vital event to the civil registration authority. Typically a parent for births, a relative or medical professional for deaths, or the parties themselves for marriages.
- [is_active](https://publicschema.org/is_active): Whether this is currently active.
- [is_enrolled](https://publicschema.org/sp/is_enrolled): Whether the person is currently enrolled in a program. Designed for verifiable credentials where enrollment status must be disclosed without revealing the specific program or detailed enrollment state. For operational queries, use enrollment_status instead.
- [is_reconciled](https://publicschema.org/is_reconciled): Whether this payment has been matched and verified against financial system records.
- [issue_date](https://publicschema.org/issue_date): The date on which this record or document was issued.
- [issued_to](https://publicschema.org/issued_to): The person, household, or group to whom the voucher is assigned.
- [issuing_authority](https://publicschema.org/issuing_authority): The organization or government body that issued the identifier.
- [issuing_authority_location](https://publicschema.org/crvs/issuing_authority_location): The civil registration office that issued the record, modeled as a Location. Distinct from the string-valued issuing_authority property used on generic identifiers.
- [issuing_jurisdiction](https://publicschema.org/issuing_jurisdiction): The geographic jurisdiction that issued the identifier, expressed as an ISO 3166-2 subdivision code or ISO 3166-1 country code.
- [issuing_office](https://publicschema.org/crvs/issuing_office): The civil registration or judicial office that issued the certificate. May differ from the office that holds the underlying record, for example when an embassy issues a certificate based on a record held elsewhere.
- [items](https://publicschema.org/items): The list of commodity line items in this delivery or voucher.
- [judgment_date](https://publicschema.org/crvs/judgment_date): The date of the court judgment that granted a divorce, annulment, adoption, paternity recognition, or other court-ordered vital event. Distinct from the registration date.
- [judgment_reference](https://publicschema.org/crvs/judgment_reference): The case number or other identifier of the court judgment that ordered this vital event. Enables retrieval of the underlying judicial record.
- [latitude](https://publicschema.org/latitude): The geographic latitude in decimal degrees (WGS84).
- [level_name](https://publicschema.org/level_name): The country-specific name for this administrative tier (e.g., state, department, commune, ward).
- [literacy](https://publicschema.org/literacy): Whether the person can, with understanding, both read and write a short simple statement on everyday life.
- [location](https://publicschema.org/location): The geographic location associated with this household, capturing coordinates or administrative area.
- [location_name](https://publicschema.org/location_name): A human-readable place name for the location.
- [locations](https://publicschema.org/locations): Named locations within or representing this geographic area.
- [longitude](https://publicschema.org/longitude): The geographic longitude in decimal degrees (WGS84).
- [manner_of_death](https://publicschema.org/crvs/manner_of_death): The circumstances under which the death occurred: natural, accident, intentional self-harm, assault, legal intervention, war, pending investigation, or could not be determined. Follows the WHO death certificate structure.
- [marital_status](https://publicschema.org/marital_status): The marital or civil status of a person as recorded in an administrative system.
- [marriage_ref](https://publicschema.org/crvs/marriage_ref): A reference to the Marriage record that this termination (divorce or annulment) dissolves. Links the end of the union back to its formation.
- [matronymic_name](https://publicschema.org/matronymic_name): A name derived from the given name of the person's mother.
- [medical_certifier](https://publicschema.org/crvs/medical_certifier): The medical practitioner who certified the cause of death. Distinct from the registrar, who records the death with the civil registration authority.
- [member_count](https://publicschema.org/member_count): The total number of members in this household or group.
- [memberships](https://publicschema.org/memberships): The membership links connecting persons to this group, each carrying role and lifecycle dates.
- [mother](https://publicschema.org/crvs/mother): The mother of the child in a paternity recognition context, where her identity is used to bind the recognition to a specific maternal record even when she is not the declarant.
- [name](https://publicschema.org/name): The full display name of the person or group.
- [nationality](https://publicschema.org/nationality): The country of citizenship or nationality, expressed as an ISO 3166-1 alpha-2 code where possible.
- [nationality_at_birth](https://publicschema.org/crvs/nationality_at_birth): The nationality acquired by the child at the time of birth, typically derived from parentage (jus sanguinis) or place of birth (jus soli) according to the applicable national law.
- [number_of_spouses](https://publicschema.org/number_of_spouses): The number of current spouses the person has. Captures polygamous or polyandrous union type separately from marital status, following the UN census framework and DHS approach.
- [object_person](https://publicschema.org/object_person): The person to whom the subject person is related (the object of the relationship statement).
- [occupation](https://publicschema.org/occupation): The person's primary occupation, classified according to the ISCO-08 sub-major groups.
- [originating_event](https://publicschema.org/crvs/originating_event): The vital event that this civil status record attests to (the birth behind a birth record, the marriage behind a marriage record, etc.). Anchors the record to its underlying occurrence.
- [parent_location](https://publicschema.org/parent_location): The parent location in the administrative hierarchy.
- [parental_role](https://publicschema.org/crvs/parental_role): The role a person holds as a parent (biological mother, biological father, legal mother, legal father, adoptive mother, adoptive father, surrogate mother). Makes biological vs. legal parentage explicit and separable.
- [parents](https://publicschema.org/crvs/parents): The parents of the child, each captured as a Parent link entity that combines a Person with a parental role (biological mother, adoptive father, etc.).
- [party_1](https://publicschema.org/crvs/party_1): One of the two parties to a marriage, divorce, or annulment. Ordering between party_1 and party_2 is arbitrary and does not imply a role or precedence.
- [party_2](https://publicschema.org/crvs/party_2): The second of the two parties to a marriage, divorce, or annulment. Ordering between party_1 and party_2 is arbitrary and does not imply a role or precedence.
- [patronymic_name](https://publicschema.org/patronymic_name): A name derived from the given name of the person's father or a paternal ancestor, used in naming conventions where patronymics are a distinct component of a person's full name.
- [payment_amount](https://publicschema.org/payment_amount): The monetary value of this payment.
- [payment_currency](https://publicschema.org/payment_currency): The ISO 4217 currency code for this payment.
- [payment_date](https://publicschema.org/payment_date): The date on which the payment was made or processed.
- [payment_status](https://publicschema.org/payment_status): The processing state of the payment.
- [person](https://publicschema.org/person): A reference to the individual Person this record relates to.
- [phone_number](https://publicschema.org/phone_number): A contact phone number for the person, including country code.
- [place_of_usual_residence](https://publicschema.org/crvs/place_of_usual_residence): The usual place of residence of the person at the time of the vital event. Used by national statistics offices to allocate vital events to the place where people live, not only where events occur.
- [place_type](https://publicschema.org/crvs/place_type): The category of place where the vital event occurred (health facility, home, en route, etc.). Complements the specific Location by describing what kind of setting it was.
- [postal_code](https://publicschema.org/postal_code): The postal or zip code of the address.
- [preferred_language](https://publicschema.org/preferred_language): The preferred language of communication for a person, using ISO 639-3 codes.
- [preferred_name](https://publicschema.org/preferred_name): The name a person is commonly known by, when it differs from their legal name. Covers chosen names, professional names, and naming conventions where given name plus family name is insufficient.
- [previous_parents](https://publicschema.org/crvs/previous_parents): The parents whose legal relationship with the adoptee is modified or terminated by the adoption. Present in full adoption (where biological parental rights end); often absent in simple adoption (where they are preserved).
- [primary_crop](https://publicschema.org/primary_crop): The primary crop or agricultural activity of the farm.
- [program_ref](https://publicschema.org/sp/program_ref): Reference to the program.
- [quantity](https://publicschema.org/quantity): The amount of a commodity in the specified unit of measure.
- [quantity_redeemed](https://publicschema.org/quantity_redeemed): The amount of this commodity that has been redeemed or collected so far.
- [raw_score](https://publicschema.org/sp/raw_score): The numeric score produced by the assessment instrument.
- [receiving_program](https://publicschema.org/receiving_program): Reference to the program or organization to which the referral is directed.
- [recipient](https://publicschema.org/recipient): The person or group that received or is intended to receive the payment. The recipient may differ from the enrolled beneficiary, for example when a guardian, payment proxy, or survivor collects on behalf of the beneficiary.
- [recognizing_parent](https://publicschema.org/crvs/recognizing_parent): The parent who is formally recognizing parentage of a child, typically a father acknowledging a child born outside marriage. Captured as a Parent link entity so the parental role is explicit.
- [record_id](https://publicschema.org/record_id): The identifier assigned to this record by the system that created it. Used to reference the record internally; distinct from any externally meaningful business reference (for example, a payment transaction number or a civil registration number) that may also be present.
- [record_type](https://publicschema.org/crvs/record_type): The type of civil status record: birth, marriage, death, paternity recognition, supplementary judgment (jugement supplétif), or a court-ordered substitute record. Determines which original vital event the record attests to.
- [redeemable_by](https://publicschema.org/redeemable_by): The person or group authorized to redeem this voucher on behalf of the beneficiary.
- [redeemed_by](https://publicschema.org/redeemed_by): The person who presented the voucher for redemption.
- [redemption_agent](https://publicschema.org/redemption_agent): The merchant, vendor, or agent who accepted the voucher for redemption.
- [redemption_date](https://publicschema.org/redemption_date): The date on which the voucher was redeemed at a vendor or agent.
- [referral_date](https://publicschema.org/referral_date): The date on which the referral was made.
- [referral_reason](https://publicschema.org/referral_reason): The basis for the referral.
- [referral_status](https://publicschema.org/referral_status): The current state of the referral (pending, accepted, declined, completed).
- [referred_person](https://publicschema.org/referred_person): The person who is being referred.
- [referring_program](https://publicschema.org/referring_program): Reference to the program or organization making the referral.
- [register_authority](https://publicschema.org/crvs/register_authority): The authority that maintains the family register. Typically a municipal or ward-level civil registration office.
- [register_number](https://publicschema.org/crvs/register_number): The unique number that identifies the family register within its issuing jurisdiction.
- [registrar](https://publicschema.org/crvs/registrar): The civil registration officer who recorded the event. In many jurisdictions this is the officer whose signature appears on the acte.
- [registration_date](https://publicschema.org/crvs/registration_date): The date on which the vital event was officially registered with the civil registration authority. May be later than the event date, especially for late registrations.
- [registration_location](https://publicschema.org/crvs/registration_location): The civil registration office where the vital event was registered. Often a municipal or district-level registry distinct from the place of occurrence.
- [registration_number](https://publicschema.org/crvs/registration_number): The unique number assigned by the civil registration authority when the vital event is registered. Serves as the primary reference for retrieving the official record.
- [registration_status](https://publicschema.org/crvs/registration_status): The lifecycle state of the registration process for this vital event: whether it is declared, pending validation, registered, rejected, cancelled, or has been corrected or archived.
- [registration_type](https://publicschema.org/crvs/registration_type): The regime under which the registration was processed: current (within the legal window), late, court-ordered, or reconstruction of a lost record. Affects legal weight and downstream uses.
- [relationship_type](https://publicschema.org/relationship_type): The nature of the relationship between two persons (e.g., spouse, parent, child, sibling, guardian, caregiver).
- [religion](https://publicschema.org/religion): The religion, religious denomination, or sect of the person, as self-identified. No international classification exists; countries define their own value sets.
- [resolution_date](https://publicschema.org/resolution_date): The date on which a resolution decision was issued for the grievance.
- [role](https://publicschema.org/role): The role of the person within the group (e.g., head, spouse, child, dependent).
- [schedule_ref](https://publicschema.org/sp/schedule_ref): Reference to the benefit schedule that this entitlement corresponds to.
- [scoring_method](https://publicschema.org/sp/scoring_method): The computational approach used to generate a welfare score from collected data.
- [serial_number](https://publicschema.org/serial_number): A public identifier for the voucher, printed on the physical document or communicated via SMS or application.
- [severity](https://publicschema.org/severity): The observed or expected severity of the event's impact.
- [sex](https://publicschema.org/sex): The biological sex of a person as recorded in an official register or identity document.
- [sex_at_birth](https://publicschema.org/crvs/sex_at_birth): The sex of the child as observed and recorded at the time of birth. Distinct from any later legal or administrative sex marker.
- [start_date](https://publicschema.org/start_date): The date on which this became effective.
- [status_in_employment](https://publicschema.org/status_in_employment): The type of employment relationship: whether the person is an employee, employer, own-account worker, contributing family worker, or cooperative member.
- [street_address](https://publicschema.org/street_address): The street name, number, and any apartment or building identifiers.
- [subject_person](https://publicschema.org/subject_person): The person who holds the described relationship (the subject of the relationship statement).
- [submission_date](https://publicschema.org/submission_date): The date on which the grievance was submitted or registered.
- [targeting_approach](https://publicschema.org/sp/targeting_approach): The method used to identify eligible beneficiaries.
- [transaction_reference](https://publicschema.org/transaction_reference): A unique reference code for this payment transaction.
- [triggering_event](https://publicschema.org/crvs/triggering_event): The subsequent vital event that prompted the annotation (for example, a marriage annotated on the birth record of a spouse, or a divorce annotated on a marriage record).
- [type_of_marriage](https://publicschema.org/crvs/type_of_marriage): The legal regime under which the marriage was contracted: civil, religious, customary, or common law. Determines which authority registered or recognized the union and how subsequent terminations are handled.
- [unit_of_measure](https://publicschema.org/unit_of_measure): The unit in which the quantity is expressed.
- [valid_until](https://publicschema.org/valid_until): The date until which the eligibility decision remains valid.
- [vital_event](https://publicschema.org/crvs/vital_event): The vital event that this certificate attests to. Used on certificates issued directly from a vital event record rather than from a stored civil status record.
- [voucher_format](https://publicschema.org/voucher_format): The physical or digital form of the voucher.
- [voucher_ref](https://publicschema.org/voucher_ref): A reference to the voucher that this record relates to.
- [voucher_status](https://publicschema.org/voucher_status): The lifecycle state of the voucher.
- [weight](https://publicschema.org/crvs/weight): The weight of the fetus at the time of a fetal death, recorded in grams. Combined with gestational age, used to classify viability and stillbirth type.
- [weight_at_birth](https://publicschema.org/crvs/weight_at_birth): The weight of the child at birth, recorded in grams. A core UN Principles and Recommendations vital statistics variable used to identify low birth weight.
- [witnesses](https://publicschema.org/crvs/witnesses): People who witnessed the vital event and attested to it at the time of registration. Witness requirements vary by jurisdiction and event type (marriages most commonly require them).

## Vocabularies

- [country](https://publicschema.org/vocab/country): Countries and territories as defined by the ISO 3166-1 standard, using alpha-2 codes.
- [adoption-type](https://publicschema.org/vocab/crvs/adoption-type): Whether an adoption fully replaces the relationship to the biological family (full adoption) or preserves some legal ties to it (simple or limited adoption). This distinction carries significant civil status implications in civil law systems.
- [annotation-type](https://publicschema.org/vocab/crvs/annotation-type): The category of a marginal annotation (mention marginale) added to a civil status record when the annotation is not derivable from a triggering vital event. Event-triggered annotations (e.g., annotating a birth acte with a marriage) carry their annotation type implicitly through the triggering event and are not listed here.
- [birth-attendant](https://publicschema.org/vocab/crvs/birth-attendant): The category of person who attended the birth. Used to track skilled birth attendance, a core indicator of maternal and newborn health.
- [birth-type](https://publicschema.org/vocab/crvs/birth-type): The number of children delivered in a single birth event.
- [cause-of-death-method](https://publicschema.org/vocab/crvs/cause-of-death-method): The method used to determine the cause of death. In many low-income settings, cause of death is ascertained by verbal autopsy rather than physician certification; consumers need to know how a reported cause was derived.
- [certificate-document-type](https://publicschema.org/vocab/crvs/certificate-document-type): The type of vital event that a certificate attests to. Describes what the document is about; orthogonal to the format of the certificate (full copy vs. extract).
- [certificate-format](https://publicschema.org/vocab/crvs/certificate-format): The format of a civil status certificate document. Distinct from the type of event it attests to: a full copy reproduces the entire acte including its marginal annotations, an extract contains only a summary.
- [civil-status-record-type](https://publicschema.org/vocab/crvs/civil-status-record-type): The type of acte represented by a civil status record. Covers the standard vital event actes and court-ordered substitutes used when original records are missing or were never created.
- [family-register-status](https://publicschema.org/vocab/crvs/family-register-status): Lifecycle status of a family register. Captures whether the register is currently active, has been closed, or was split into or merged with other registers following vital events.
- [manner-of-death](https://publicschema.org/vocab/crvs/manner-of-death): How a death occurred, as distinct from its underlying medical cause. Aligned with WHO/ICD Manner of Death classification.
- [marriage-type](https://publicschema.org/vocab/crvs/marriage-type): The legal or traditional framework under which a marriage was contracted.
- [parental-role](https://publicschema.org/vocab/crvs/parental-role): The type of parental relationship a person has in the context of a vital event. Distinguishes biological, legal, adoptive, and surrogate parental roles by gender to match civil law and paternity recognition conventions.
- [place-type](https://publicschema.org/vocab/crvs/place-type): The category of place where a vital event occurred (birth or death). Distinct from the specific Location: this captures the type (health facility, home, etc.) rather than the named place.
- [registration-status](https://publicschema.org/vocab/crvs/registration-status): Lifecycle states of the registration of a vital event, from initial declaration through validation, archival, or cancellation.
- [registration-type](https://publicschema.org/vocab/crvs/registration-type): Categories describing whether the registration of a vital event occurred within the legal time limit, after it, or through a special procedure.
- [currency](https://publicschema.org/vocab/currency): Currency codes as defined by the ISO 4217 standard.
- [delivery-channel](https://publicschema.org/vocab/delivery-channel): The mechanisms through which benefit transfers reach beneficiaries.
- [education-level](https://publicschema.org/vocab/education-level): The highest level of education completed by a person, classified according to the International Standard Classification of Education (ISCED 2011).
- [employment-status](https://publicschema.org/vocab/employment-status): The labour force participation status of a person, classified according to the ILO 19th International Conference of Labour Statisticians (2013) tripartite framework.
- [event-certainty](https://publicschema.org/vocab/event-certainty): The confidence that an event has occurred or will occur. Values are compatible with OASIS CAP v1.2 certainty codes.
- [event-severity](https://publicschema.org/vocab/event-severity): The observed or expected severity of an event's impact. Values are compatible with OASIS CAP v1.2 severity codes.
- [gender-type](https://publicschema.org/vocab/gender-type): The administrative gender of a person as recorded in a registry or identity system. Distinct from biological sex (see the sex vocabulary). No single international standard governs gender vocabulary; ISO/IEC 5218 explicitly covers biological sex only. This vocabulary provides a minimal common set based on what administrative systems actually record.
- [group-role](https://publicschema.org/vocab/group-role): The role a person plays within a group such as a household, family, or other organizational unit. Roles are defined relative to the group's reference person (head).
- [group-type](https://publicschema.org/vocab/group-type): Categories used to classify the administrative or social type of a group in a public service delivery system.
- [hazard-type](https://publicschema.org/vocab/hazard-type): The category of hazard or disruptive event, based on the Sendai Framework classification with extensions for social and economic shocks.
- [identifier-type](https://publicschema.org/vocab/identifier-type): Categories of identifier documents or numbers used to identify persons in administrative and service delivery systems.
- [language](https://publicschema.org/vocab/language): Language codes as defined by the ISO 639-3 standard, covering all known human languages.
- [literacy](https://publicschema.org/vocab/literacy): Whether a person can, with understanding, both read and write a short simple statement on everyday life.
- [marital-status](https://publicschema.org/vocab/marital-status): Categories describing a person's marital or civil status as recorded in a registry or administrative system.
- [occupation](https://publicschema.org/vocab/occupation): Categories describing a person's occupation, based on the full ISCO-08 classification hierarchy (major groups, sub-major groups, minor groups, and unit groups).
- [payment-status](https://publicschema.org/vocab/payment-status): The processing states of a payment event in the disbursement cycle.
- [region](https://publicschema.org/vocab/region): Geographic regions and country groupings as defined by the United Nations M49 standard.
- [relationship-type](https://publicschema.org/vocab/relationship-type): Categories describing the nature of the connection between two persons, covering kinship, administrative, and economic relationships.
- [script](https://publicschema.org/vocab/script): Writing system codes as defined by the ISO 15924 standard.
- [sex](https://publicschema.org/vocab/sex): The biological sex of a person as recorded in an official register or identity document, following ISO/IEC 5218.
- [benefit-frequency](https://publicschema.org/vocab/sp/benefit-frequency): The schedule on which a benefit or transfer is provided to a recipient, ranging from one-time payments to recurring disbursements at fixed intervals.
- [benefit-modality](https://publicschema.org/vocab/sp/benefit-modality): The form in which a benefit or entitlement is delivered to a beneficiary.
- [conditionality-type](https://publicschema.org/vocab/sp/conditionality-type): Categories describing whether and how a social protection program requires beneficiaries to meet behavioral conditions to receive or continue receiving benefits.
- [eligibility-status](https://publicschema.org/vocab/sp/eligibility-status): The possible outcomes of a formal eligibility determination for a program or service.
- [enrollment-exit-reason](https://publicschema.org/vocab/sp/enrollment-exit-reason): The reason an enrollment was permanently closed. Applies when enrollment status is closed, not when graduated.
- [enrollment-status](https://publicschema.org/vocab/sp/enrollment-status): The lifecycle states of an enrollment in a program.
- [entitlement-status](https://publicschema.org/vocab/sp/entitlement-status): The lifecycle states of a benefit entitlement instance, from creation through fulfillment or termination.
- [grievance-status](https://publicschema.org/vocab/sp/grievance-status): The lifecycle states of a grievance record in a program or service.
- [grievance-type](https://publicschema.org/vocab/sp/grievance-type): Categories describing the nature of a grievance or complaint received by a program through its redress mechanism.
- [referral-status](https://publicschema.org/vocab/sp/referral-status): The lifecycle states of a referral between programs or services.
- [targeting-approach](https://publicschema.org/vocab/sp/targeting-approach): The methods used to identify and select eligible beneficiaries for a social protection program.
- [status-in-employment](https://publicschema.org/vocab/status-in-employment): The type of employment relationship a person has, classified according to the ILO International Classification of Status in Employment (ICSE-18).
- [unit-of-measure](https://publicschema.org/vocab/unit-of-measure): Units of measure for quantities of goods distributed or redeemable through benefit programs.
- [voucher-format](https://publicschema.org/vocab/voucher-format): The physical or digital form of a voucher.
- [voucher-status](https://publicschema.org/vocab/voucher-status): The lifecycle states of a voucher instrument, from creation through redemption or expiry.

## Documentation

- [Integration Patterns](https://publicschema.org/docs/integration-patterns/): How PublicSchema works across REST APIs, event-driven systems, verifiable credentials, file exchanges, and analytics pipelines.
- [Use Cases](https://publicschema.org/docs/use-cases/): Concrete scenarios showing how PublicSchema helps programs coordinate, share data, and reach people across sectors.
- [Vocabulary Adoption Guide](https://publicschema.org/docs/vocabulary-adoption-guide/): The lightest integration path: align your system's codes and field values to canonical vocabularies without changing your data model.
- [Interoperability & Mapping Guide](https://publicschema.org/docs/interoperability-guide/): Using PublicSchema as a Rosetta Stone to map fields and codes between systems, build data exchanges, and consolidate records.
- [Data Model Design Guide](https://publicschema.org/docs/data-model-guide/): Using PublicSchema as a reference when designing a new system's data model for interoperability from the start.
- [JSON-LD & Verifiable Credentials Guide](https://publicschema.org/docs/jsonld-vc-guide/): How to use PublicSchema with JSON-LD contexts, JSON Schema validation, and SD-JWT Verifiable Credentials.
- [Extension Mechanism](https://publicschema.org/docs/extension-mechanism/): Adding custom properties, vocabulary values, and concepts using JSON-LD namespaces.
- [Selective Disclosure](https://publicschema.org/docs/selective-disclosure/): Privacy design for Verifiable Credentials using SD-JWT.
- [Versioning and Maturity](https://publicschema.org/docs/versioning-and-maturity/): Stability guarantees, maturity levels, and URI persistence.
- [Design Principles](https://publicschema.org/docs/design-principles/): The foundational philosophy behind PublicSchema: semantic not structural, descriptive not prescriptive, evidence-based.
- [Schema Design](https://publicschema.org/docs/schema-design/): How elements are named, scoped, and modeled. Naming conventions, domain namespacing, and the concept/property/vocabulary decision tree.
- [Vocabulary Design](https://publicschema.org/docs/vocabulary-design/): Rules for designing controlled vocabularies, referencing standards, and validating through system mappings.
- [Related Standards](https://publicschema.org/docs/related-standards/): How PublicSchema relates to DCI, GovStack, FHIR, EU Core Vocabularies, and other initiatives.

## Full content

- [llms-full.txt](https://publicschema.org/llms-full.txt): Complete definitions for all concepts, properties, and vocabularies