Documentation
Guides, technical references, and background on PublicSchema.
Getting Started
Integration Patterns
How PublicSchema works across REST APIs, event-driven systems, verifiable credentials, file exchanges, and analytics pipelines.
Use Cases
Concrete scenarios showing how PublicSchema helps programs coordinate, share data, and reach people across sectors.
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
Using PublicSchema as a Rosetta Stone to map fields and codes between systems, build data exchanges, and consolidate records.
Data Model Design Guide
Using PublicSchema as a reference when designing a new system's data model for interoperability from the start.
JSON-LD & Verifiable Credentials Guide
How to use PublicSchema with JSON-LD contexts, JSON Schema validation, and SD-JWT Verifiable Credentials.
Design Principles
The foundational philosophy behind PublicSchema: semantic not structural, descriptive not prescriptive, evidence-based.
Technical Documentation
Domain migration
Canonical domains, moved terms and migration of existing references.
FHIR registry integration
Connecting health facilities and registry records to FHIR resources.
Facility roles
Distinguishing facilities, their operators and their service delivery roles.
Relationship date conversion
Converting inclusive source validity dates on relationships and periods of responsibility.
Public services
Public services, applications, decisions, appeals and organizational succession.
Ownership and education delivery
Ownership interests, legal arrangements, education programs, offerings and awarded qualifications.
Registry foundations
Registers, records, recognition, evidence, coded values, quantities and geometry.
Farm and holder responsibilities
Farms, agricultural holder roles, farmer registration and work on a holding.
Government registries
Public organizations, institutional roles, assets, ownership, regulation, tax, elections and transport.
Animals and plants
Animals, crops, varieties, accessions and seed lots.
Agricultural operations
Facilities, input products, service roles, certification and water use.
Metrics Specification
Aggregate indicators, declarative calculations, dimensions, and alignment with external standards.
Extension Mechanism
Adding custom properties, vocabulary values, and concepts using JSON-LD namespaces.
Selective Disclosure
Privacy design for Verifiable Credentials using SD-JWT.
Versioning and Maturity
Stability guarantees, maturity levels, and URI persistence.
Schema Design
How elements are named, scoped, and modeled. Naming conventions, domain namespacing, and the concept/property/vocabulary decision tree.
Vocabulary Design
Rules for designing controlled vocabularies, referencing standards, and validating through system mappings.
FHIR Mapping Guide
Exchanging PublicSchema disability, functioning, and anthropometric data over FHIR R4: Observation vs. QuestionnaireResponse, LOINC coding, and IPS alignment.