ATC Code Details
atc_lookupResolve an ATC code at levels 1–4 to its class name and hierarchy level, confirming the code exists and identifying whether it is anatomical, therapeutic, pharmacological, or chemical.
Instructions
Look up an ATC code at level 1-4 to get its name and hierarchy level.
Use this tool to:
Resolve an ATC code (e.g., "A10BA") to its class name ("Biguanides")
Confirm a code exists in the current ATC index
Identify the level (anatomical / therapeutic / pharmacological / chemical)
Accepts codes 1-5 characters long: "A" (anatomical), "A10" (therapeutic), "A10B" (pharmacological), "A10BA" (chemical). Substance-level codes (7 chars, e.g., "A10BA02") are not exposed by this endpoint — use atc_classify with the drug name to retrieve the substance code.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"atc_code": "<atc_code>"
},
"name": "atc_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| atc_code | Yes | ATC code at level 1-4 (1-5 chars). Substance-level codes (7 chars, e.g., A10BA02) are not exposed by this endpoint — use atc_classify with the drug name instead. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| found | Yes | Whether RxClass knows the code at level 1-4; false for unknown and for 7-character substance codes. | |
| details | Yes | The ATC class (code, name, level type); null when found=false. | |
| atc_code | Yes | The ATC code as submitted. | |
| provenance | Yes | Provenance block: source, URL, data vintage, extraction instant, origin diagnostics, citation, license | |
| attribution | Yes | Canonical source URLs of this response (attribution list) |