{"openapi":"3.1.0","info":{"title":"ATC Drug Classification API","version":"1.0.0","description":"The WHO ATC (Anatomical Therapeutic Chemical) drug classification as an API — 6,400+ codes organising every medicine into a 5-level hierarchy: anatomical main group → therapeutic subgroup → pharmacological subgroup → chemical subgroup → chemical substance. Look up any ATC code (e.g. A10BA02 → metformin, N02BE01 → paracetamol, J01CA04 → amoxicillin) with its full ancestor chain, direct children and WHO Defined Daily Doses (DDD); search drugs by name; or navigate the tree from the 14 anatomical main groups. Ideal for e-prescribing, pharmacy, clinical decision support, drug databases and health analytics.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/atc-api","description":"oanor gateway"}],"tags":[{"name":"ATC"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/children":{"get":{"operationId":"get_v1_children","tags":["ATC"],"summary":"Direct children of a code (or the 14 main groups)","description":"","parameters":[{"name":"code","in":"query","required":false,"description":"Parent code, e.g. A10 (omit to list main groups)","schema":{"type":"string"},"example":"A10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"A10","name":"DRUGS USED IN DIABETES","count":3,"level":"therapeutic_subgroup","children":[{"code":"A10A","name":"INSULINS AND ANALOGUES","level":"pharmacological_subgroup"},{"code":"A10B","name":"BLOOD GLUCOSE LOWERING DRUGS, EXCL. INSULINS","level":"pharmacological_subgroup"},{"code":"A10X","name":"OTHER DRUGS USED IN DIABETES","level":"pharmacological_subgroup"}]},"meta":{"timestamp":"2026-05-31T06:28:01.079Z","request_id":"12220544-7b7c-4370-b668-d452865d5fe8"},"status":"ok","message":"Children listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/code":{"get":{"operationId":"get_v1_code","tags":["ATC"],"summary":"An ATC code with ancestors, children & DDDs","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"ATC code, e.g. A10BA02 (metformin)","schema":{"type":"string"},"example":"A10BA02"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"A10BA02","ddds":[{"ddd":"2","uom":"g","route":"O"}],"name":"metformin","level":"chemical_substance","parent":"A10BA","children":[],"ancestors":[{"code":"A","name":"ALIMENTARY TRACT AND METABOLISM","level":"anatomical_main_group"},{"code":"A10","name":"DRUGS USED IN DIABETES","level":"therapeutic_subgroup"},{"code":"A10B","name":"BLOOD GLUCOSE LOWERING DRUGS, EXCL. INSULINS","level":"pharmacological_subgroup"},{"code":"A10BA","name":"Biguanides","level":"chemical_subgroup"}],"level_num":5,"children_count":0},"meta":{"timestamp":"2026-05-31T06:28:01.155Z","request_id":"f8e50b3a-5d73-4f30-8bb0-2419e16b83e2"},"status":"ok","message":"ATC code retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["ATC"],"summary":"Search drugs / groups by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Name search, e.g. metformin","schema":{"type":"string"},"example":"metformin"},{"name":"level","in":"query","required":false,"description":"anatomical_main_group | therapeutic_subgroup | pharmacological_subgroup | chemical_subgroup | chemical_substance","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":19,"limit":20,"query":"metformin","total":19,"offset":0,"results":[{"code":"A10BA02","ddds":[{"ddd":"2","uom":"g","route":"O"}],"name":"metformin","level":"chemical_substance","parent":"A10BA","level_num":5},{"code":"A10BD02","name":"metformin and sulfonylureas","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD03","name":"metformin and rosiglitazone","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD05","name":"metformin and pioglitazone","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD07","name":"metformin and sitagliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD08","name":"metformin and vildagliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD10","name":"metformin and saxagliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD11","name":"metformin and linagliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD13","name":"metformin and alogliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD14","name":"metformin and repaglinide","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD15","name":"metformin and dapagliflozin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD16","name":"metformin and canagliflozin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD17","name":"metformin and acarbose","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD18","name":"metformin and gemigliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD20","name":"metformin and empagliflozin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD22","name":"metformin and evogliptin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD23","name":"metformin and ertugliflozin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD25","name":"metformin, saxagliptin and dapagliflozin","level":"chemical_substance","parent":"A10BD","level_num":5},{"code":"A10BD26","name":"metformin and lobeglitazone","level":"chemical_substance","parent":"A10BD","level_num":5}]},"meta":{"timestamp":"2026-05-31T06:28:01.240Z","request_id":"e139766f-2130-4135-aa07-74e8eaf52d6f"},"status":"ok","message":"ATC codes listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & level breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"5 levels by code length (1/3/4/5/7 chars). DDD = WHO Defined Daily Dose (uom unit, route O=oral/P=parenteral/…).","total":6440,"fields":["code","name","level","level_num","parent","ddds","ancestors","children"],"levels":[{"count":14,"level":"anatomical_main_group","level_num":1},{"count":94,"level":"therapeutic_subgroup","level_num":2},{"count":269,"level":"pharmacological_subgroup","level_num":3},{"count":909,"level":"chemical_subgroup","level_num":4},{"count":5154,"level":"chemical_substance","level_num":5}],"source":"WHO ATC/DDD classification (2021)"},"meta":{"timestamp":"2026-05-31T06:28:01.313Z","request_id":"1d0d75f3-f2c7-416f-93a5-103edc38fc27"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":450,"monthly_call_quota":55000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1400,"monthly_call_quota":280000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3600,"monthly_call_quota":1400000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/atc-api"}