Data model / schema · 2.0 · current maintained version

GA4GH Phenopackets

Maintained by GA4GH

What it helps you do

Use Phenopackets when you need human- and machine-readable case-level phenotypic, clinical, diagnosis, measurement, biosample, and genomic interpretation data.

  • Clinical
  • Omics
  • Rare disease
PlanAcquireHarmonizeExchangeLearn + reuse

01

Where it fits—and where it doesn’t

Use these four checks before committing implementation time.

Use it when
Portable phenotype/genotype exchange for rare disease, cancer, registries, diagnostics, and computational analysis.
Do not use it as
Do not treat Phenopackets as a complete solution on its own. Flexible optionality and ontology dependence require application-specific validation; it does not replace an EHR API, consent layer, or cohort warehouse.
Best for
Teams working with Clinical and Omics and Rare disease data across Harmonize → Exchange → Learn + reuse.
Maturity
ScalingUsable today, with adoption or tooling still scaling; pilot the exact stack you plan to run.

02

See it in the workflow

A standard creates value by changing a handoff, not by existing in a catalog.

  1. InputWhat starts

    Clinical and Omics and Rare disease data, metadata, and the local decisions around them

  2. PhenopacketsWhat changes

    Phenopackets applies a shared data model / schema across Harmonize → Exchange → Learn + reuse

  3. OutputWhat becomes possible

    A more consistent, reviewable handoff for the next system or team

Readiness gateBefore scaling: Flexible optionality and ontology dependence require application-specific validation; it does not replace an EHR API, consent layer, or cohort warehouse.

03

A concrete example

A rare-disease program validates a v2 Phenopacket with pinned ontology versions, measurements, disease course, biosamples, and variant interpretations.

Why it matters: Provides computable phenotype features and temporal context, while cohort construction, missingness, bias, and leakage controls remain external.

04

What it fits with

Works with GA4GH variation standards and community ontologies, and is designed to interoperate with FHIR; it is not a longitudinal warehouse.

05

Implementation starter

Start with one bounded handoff. Pin, test, and review it before scaling.

  1. Name an accountable owner and the decision Phenopackets must support.

  2. Pin the exact version and companion artifacts: 2.0 · current maintained version.

  3. Map one representative input to the required data model / schema artifacts.

  4. Test the result against the canonical source and record every exception.

  5. Preserve the source data, mappings, and review evidence before scaling.

06

Limitation to test first—and the tests that catch it

Risk

Flexible optionality and ontology dependence require application-specific validation; it does not replace an EHR API, consent layer, or cohort warehouse.

Test

Run one representative end-to-end pilot and record exactly where Phenopackets loses context, needs an extension, or depends on another standard.

Risk

A structured or machine-readable result can still be unfit for analysis or AI.

Test

Test the output for missing context, provenance, terminology alignment, time leakage, and the intended downstream decision. Provides computable phenotype features and temporal context, while cohort construction, missingness, bias, and leakage controls remain external.

07

Why we believe this

Checked against the canonical source plus independent operational evidence from an adopter, regulator, or implementation report.

Evidence notation: E1 + E2. The code is shorthand; the plain-language statement above is the claim.

Formal status
GA4GH current maintained v2.0
Confidence
High
Review state
Source-checked
Reviewed by
Clinical genomics reviewer
Last verified
13 July 2026
Review again when
Schema, validator, ontology, or implementation update
How the evidence method works

08

Source shelf

Official diagrams, examples, specifications, and explainers. Nothing external loads until you choose to open it.

  • Primary source2.0 · current maintained version

    GA4GH Phenopackets

    The canonical publisher or steward source used to verify this data model / schema profile.

    Publisher
    GA4GH
    Rights
    Rights remain with the publisher; this knowledge base links to the source rather than copying it.
    Access
    Opens the publisher's source in a new tab; no external media loads on this page.
    Verified
    2026-07-13
    Open at source

Next action

Put this profile in context

Compare its role with adjacent standards or place it inside an end-to-end data pathway before choosing an implementation.