# 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

```bash
# 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:

```bash
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`.