{"openapi":"3.1.0","info":{"title":"ICD-10 Codes API","version":"1.0.0","description":"The ICD-10-CM diagnosis code system as an API — 71,000+ International Classification of Diseases (10th revision, Clinical Modification) codes used in healthcare, billing and insurance. Look up any code (e.g. E11.9 → Type 2 diabetes mellitus without complications), search the classification by condition, or browse every code in a 3-character category. Ideal for EHR/EMR systems, medical billing, claims and health-tech tooling.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/icd10-api","description":"oanor gateway"}],"tags":[{"name":"ICD-10"},{"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/category":{"get":{"operationId":"get_v1_category","tags":["ICD-10"],"summary":"All codes in a 3-character category","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"3-character category, e.g. E11","schema":{"type":"string"},"example":"E11"},{"name":"limit","in":"query","required":false,"description":"Max codes (1-500, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"codes":[{"code":"E11.00","category":"E11","description":"Type 2 diabetes mellitus with hyperosmolarity without nonketotic hyperglycemic-hyperosmolar coma (NKHHC)"},{"code":"E11.01","category":"E11","description":"Type 2 diabetes mellitus with hyperosmolarity with coma"},{"code":"E11.10","category":"E11","description":"Type 2 diabetes mellitus with ketoacidosis without coma"},{"code":"E11.11","category":"E11","description":"Type 2 diabetes mellitus with ketoacidosis with coma"},{"code":"E11.21","category":"E11","description":"Type 2 diabetes mellitus with diabetic nephropathy"},{"code":"E11.22","category":"E11","description":"Type 2 diabetes mellitus with diabetic chronic kidney disease"},{"code":"E11.29","category":"E11","description":"Type 2 diabetes mellitus with other diabetic kidney complication"},{"code":"E11.311","category":"E11","description":"Type 2 diabetes mellitus with unspecified diabetic retinopathy with macular edema"},{"code":"E11.319","category":"E11","description":"Type 2 diabetes mellitus with unspecified diabetic retinopathy without macular edema"},{"code":"E11.3211","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy with macular edema, right eye"},{"code":"E11.3212","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy with macular edema, left eye"},{"code":"E11.3213","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy with macular edema, bilateral"},{"code":"E11.3219","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy with macular edema, unspecified eye"},{"code":"E11.3291","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy without macular edema, right eye"},{"code":"E11.3292","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy without macular edema, left eye"},{"code":"E11.3293","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy without macular edema, bilateral"},{"code":"E11.3299","category":"E11","description":"Type 2 diabetes mellitus with mild nonproliferative diabetic retinopathy without macular edema, unspecified eye"},{"code":"E11.3311","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy with macular edema, right eye"},{"code":"E11.3312","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy with macular edema, left eye"},{"code":"E11.3313","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy with macular edema, bilateral"},{"code":"E11.3319","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy with macular edema, unspecified eye"},{"code":"E11.3391","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy without macular edema, right eye"},{"code":"E11.3392","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy without macular edema, left eye"},{"code":"E11.3393","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy without macular edema, bilateral"},{"code":"E11.3399","category":"E11","description":"Type 2 diabetes mellitus with moderate nonproliferative diabetic retinopathy without macular edema, unspecified eye"},{"code":"E11.3411","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy with macular edema, right eye"},{"code":"E11.3412","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy with macular edema, left eye"},{"code":"E11.3413","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy with macular edema, bilateral"},{"code":"E11.3419","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy with macular edema, unspecified eye"},{"code":"E11.3491","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy without macular edema, right eye"},{"code":"E11.3492","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy without macular edema, left eye"},{"code":"E11.3493","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy without macular edema, bilateral"},{"code":"E11.3499","category":"E11","description":"Type 2 diabetes mellitus with severe nonproliferative diabetic retinopathy without macular edema, unspecified eye"},{"code":"E11.3511","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with macular edema, right eye"},{"code":"E11.3512","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with macular edema, left eye"},{"code":"E11.3513","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with macular edema, bilateral"},{"code":"E11.3519","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with macular edema, unspecified eye"},{"code":"E11.3521","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment involving the macula, right eye"},{"code":"E11.3522","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment involving the macula, left eye"},{"code":"E11.3523","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment involving the macula, bilateral"},{"code":"E11.3529","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment involving the macula, unspecified eye"},{"code":"E11.3531","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment not involving the macula, right eye"},{"code":"E11.3532","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment not involving the macula, left eye"},{"code":"E11.3533","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment not involving the macula, bilateral"},{"code":"E11.3539","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with traction retinal detachment not involving the macula, unspecified eye"},{"code":"E11.3541","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with combined traction retinal detachment and rhegmatogenous retinal detachment, right eye"},{"code":"E11.3542","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with combined traction retinal detachment and rhegmatogenous retinal detachment, left eye"},{"code":"E11.3543","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with combined traction retinal detachment and rhegmatogenous retinal detachment, bilateral"},{"code":"E11.3549","category":"E11","description":"Type 2 diabetes mellitus with proliferative diabetic retinopathy with combined traction retinal detachment and rhegmatogenous retinal detachment, unspecified eye"},{"code":"E11.3551","category":"E11","description":"Type 2 diabetes mellitus with stable proliferative diabetic retinopathy, right eye"}],"count":50,"total":86,"category":"E11"},"meta":{"timestamp":"2026-05-31T03:01:29.859Z","request_id":"c1204638-6386-44db-a9c5-26e99ad650c7"},"status":"ok","message":"Category 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/code":{"get":{"operationId":"get_v1_code","tags":["ICD-10"],"summary":"A single ICD-10 code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"ICD-10 code, e.g. E11.9 or E119","schema":{"type":"string"},"example":"E11.9"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"E11.9","category":"E11","description":"Type 2 diabetes mellitus without complications"},"meta":{"timestamp":"2026-05-31T03:01:29.933Z","request_id":"93e59c6f-34c4-48b0-aa4c-6eccb771556f"},"status":"ok","message":"ICD-10 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":["ICD-10"],"summary":"Search ICD-10 codes by condition","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Condition / description text","schema":{"type":"string"},"example":"diabetes"},{"name":"category","in":"query","required":false,"description":"Restrict to a 3-character category","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":20,"limit":20,"query":"diabetes","total":478,"offset":0,"results":[{"code":"E08.00","category":"E08","description":"Diabetes mellitus due to underlying condition with hyperosmolarity without nonketotic hyperglycemic-hyperosmolar coma (NKHHC)"},{"code":"E08.01","category":"E08","description":"Diabetes mellitus due to underlying condition with hyperosmolarity with coma"},{"code":"E08.10","category":"E08","description":"Diabetes mellitus due to underlying condition with ketoacidosis without coma"},{"code":"E08.11","category":"E08","description":"Diabetes mellitus due to underlying condition with ketoacidosis with coma"},{"code":"E08.21","category":"E08","description":"Diabetes mellitus due to underlying condition with diabetic nephropathy"},{"code":"E08.22","category":"E08","description":"Diabetes mellitus due to underlying condition with diabetic chronic kidney disease"},{"code":"E08.29","category":"E08","description":"Diabetes mellitus due to underlying condition with other diabetic kidney complication"},{"code":"E08.311","category":"E08","description":"Diabetes mellitus due to underlying condition with unspecified diabetic retinopathy with macular edema"},{"code":"E08.319","category":"E08","description":"Diabetes mellitus due to underlying condition with unspecified diabetic retinopathy without macular edema"},{"code":"E08.3211","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy with macular edema, right eye"},{"code":"E08.3212","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy with macular edema, left eye"},{"code":"E08.3213","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy with macular edema, bilateral"},{"code":"E08.3219","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy with macular edema, unspecified eye"},{"code":"E08.3291","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy without macular edema, right eye"},{"code":"E08.3292","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy without macular edema, left eye"},{"code":"E08.3293","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy without macular edema, bilateral"},{"code":"E08.3299","category":"E08","description":"Diabetes mellitus due to underlying condition with mild nonproliferative diabetic retinopathy without macular edema, unspecified eye"},{"code":"E08.3311","category":"E08","description":"Diabetes mellitus due to underlying condition with moderate nonproliferative diabetic retinopathy with macular edema, right eye"},{"code":"E08.3312","category":"E08","description":"Diabetes mellitus due to underlying condition with moderate nonproliferative diabetic retinopathy with macular edema, left eye"},{"code":"E08.3313","category":"E08","description":"Diabetes mellitus due to underlying condition with moderate nonproliferative diabetic retinopathy with macular edema, bilateral"}]},"meta":{"timestamp":"2026-05-31T03:01:30.015Z","request_id":"4ea0f380-1b45-468f-8a10-a270faca6dfc"},"status":"ok","message":"Search completed","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 & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Diagnosis codes; category = first 3 characters of the code.","total":71704,"fields":["code","description","category","category_title"],"source":"ICD-10-CM (Clinical Modification)","categories":1910},"meta":{"timestamp":"2026-05-31T03:01:30.062Z","request_id":"41d7369f-aa3f-4285-b4d9-ae48416f4430"},"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":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1200,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"enterprise","name":"Enterprise","price_cents_month":12000,"monthly_call_quota":1500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/icd10-api"}