termbank.pdhc — User manual

Read API + import CLIs live since Phase 3 (mid-2026). Below is the
current operator + integrator surface.

Who this is for

Platform operators and developers of other PDHC services (plan.pdhc, rosetta.pdhc, cdr.pdhc, forms.pdhc, etc.) that need to resolve canonical terminology URIs.

End users never reach termbank.pdhc directly — they interact through plan.pdhc's curation UI, which browses termbank.pdhc on their behalf.

Quick start

# Look up a concept by system + code
curl https://termbank.pdhc.se/CodeSystem/loinc/4548-4

# Look up by canonical URI
curl 'https://termbank.pdhc.se/Concept?uri=https://termbank.pdhc.se/CodeSystem/loinc/4548-4'

# FHIR R5 $lookup (spec-shaped)
curl 'https://termbank.pdhc.se/fhir/CodeSystem/$lookup?system=loinc&code=4548-4'

# Fuzzy search across display + designations
curl 'https://termbank.pdhc.se/search?q=HbA1c&system=loinc&limit=20'

Import (operator only)

All imports are CLI-only (Rule 6). Examples:

python scripts/import_loinc.py --release-csv Loinc_2.82/LoincTable.csv --version 2.82
python scripts/import_snomed.py --release-dir SnomedCT_ManagedServiceSE_PRODUCTION_SE1000052_20251130T120000Z --version 20251130
python scripts/import_icd10.py --release-tsv icd-10-se.tsv --version 2026
python scripts/import_atc.py --version 2025
python scripts/import_kva.py --version 2026

Re-running an import with an already-imported --version is a no-op. A new version bumps the version field but preserves canonical_uri.