GET /data/clinicalAnnotation

pharmgkb.org:pharmgkb-api

Summary: Query Clinical Annotations
Operation ID:
Auth: none

Parameters (7)

id (string, query, optional)

the ClinPGx identifier of the Clinical Annotation

levelOfEvidence.term (string, query, optional)

the level of Clinical Annotations to retrieve

Constraints: {'enum': ['1A', '1B', '2A', '2B', '3', '4']}

location.fingerprint (string, query, optional)

the fingerprint (most often RSID) of the Variant to get Clinical Annotations for

location.genes.symbol (string, query, optional)

the symbol of the Gene to get Clinical Annotations for

relatedChemicals.accessionId (string, query, optional)

the accession ID of a chemical associated with the Clinical Annotation

relatedChemicals.name (string, query, optional)

the name of a chemical associated with the Clinical Annotation

view (string, query, optional)

How much data to retrieve on the object

Constraints: {'enum': ['min', 'base', 'max']}

Examples (3)

TitleTypeURLAction
Query by gene symbol (CYP2D6) curl https://api.pharmgkb.org/data/clinicalAnnotation?location.genes.symbol=CYP2D6
Query by RSID variant fingerprint curl https://api.pharmgkb.org/data/clinicalAnnotation?location.fingerprint=rs1799853
Query by level of evidence curl https://api.pharmgkb.org/data/clinicalAnnotation?levelOfEvidence.term=1A

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:30:17.214622 200 2140ms 2.0MB
2026-03-23 09:13:17.454452 200 1377ms 1.2MB
2026-03-23 09:01:22.569569 200 1065ms

Response Changes

WhenOldNew
2026-03-23 09:13:17.454452 2861111a40a0 c472b2cf3f30
2026-03-23 10:30:17.214622 c472b2cf3f30 f2c15ff1f40f