Back to Changelog
Feature

New ATHENA Vocabulary Release (v20260227)

OHDSI Vocabulary v20260227 is now available on OMOPHub as the default version - featuring HPO as a new vocabulary, 100K+ new concepts, and thousands of improved mappings.

The latest OHDSI ATHENA vocabulary release (v20260227) is now live on OMOPHub and set as the default version for all API requests.

What's New

HPO (Human Phenotype Ontology)

HPO has been added as a new vocabulary with ~19,400 concepts describing human phenotypic abnormalities. These concepts are mapped to SNOMED, making HPO immediately useful for phenotype-driven research and rare disease studies.

# Find HPO concepts
results = client.search("seizure", vocabulary_ids=["HPO"])
# Returns: Seizure (HP:0001250), Febrile seizure (HP:0002373), ...

100K+ New Concepts

Significant concept additions across multiple vocabularies:

VocabularyNew ConceptsNotes
SPL~41,000Structured Product Labeling
NDC~24,000National Drug Codes
HPO~19,400New vocabulary
CIEL~7,500Columbia International eHealth Laboratory
EDI~4,700Korean EDI codes
RxNorm~2,000Drug terminology
VANDF~1,300VA National Drug File

Improved Concept Mappings

  • 27,000+ RxNorm Extension concepts remapped to standard RxNorm equivalents
  • Thousands of new and updated mappings across vocabularies
  • Domain reassignments across CIEL and MeSH for better classification

New Vocabulary Dependencies

CIEL now includes dependencies on LOINC, OMOP Extension, CVX, and other vocabularies - expanding cross-vocabulary interoperability.

Accessing the New Version

The v20260227 release is the new default. All API requests without a version pin automatically use this version:

# Uses latest (v20260227) by default
curl "https://api.omophub.com/v1/concepts/201826" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Pin to a specific version
curl "https://api.omophub.com/v1/concepts/201826" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Vocabulary-Version: 2025.2"

Version Pinning

If your application depends on a specific vocabulary version, we recommend pinning to avoid unexpected changes when new versions are released:

# Pin to the previous version
client = omophub.OMOPHub(api_key="oh_xxx", vocab_version="2025.2")

# Use the new release explicitly
client = omophub.OMOPHub(api_key="oh_xxx", vocab_version="2026.1")

Existing applications with version pinning are unaffected by this update.

Full Release Notes

For the complete list of changes, see the OHDSI Vocabulary v20260227 release notes on GitHub.