{"uid":"cap__xcx9LAsOZd91nOi39PEa","slug":"icd-10-cm-code-lookup-and-verification-api-cdd88147","name":"ICD-10-CM Code Lookup and Verification API","description":"Verify and search ICD-10-CM diagnosis codes against the official US code set (FY2026, ~98k entries). Pass code (with or without the dot, e.g. E11.9 or E119) to confirm the code exists and list its more-specific child codes, or q to keyword-search code descriptions (e.g. \"type 2 diabetes neuropathy\"). Optional billable_only=true restricts results to codes valid for claim submission; limit caps results (1-50, default 10). Returns a verified flag, the exact match if any, and matched codes with billable status plus short and long descriptions. Data: CMS/NCHS ICD-10-CM (public domain), refreshed each US fiscal year. Use to confirm diagnosis codes are real and current before placing them in claims, prior authorizations, or clinical documents.","url":"https://2s.io/api/medical/icd10","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"q":{"type":"string","maxLength":120,"minLength":3,"description":"Keyword search over official code descriptions (e.g. \"type 2 diabetes neuropathy\"). Every word must match. Provide either code or q, not both."},"code":{"type":"string","maxLength":9,"minLength":3,"description":"ICD-10-CM code to verify, with or without the dot (e.g. E11.9 or E119). Returns the exact match plus more-specific child codes. Provide either code or q, not both."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum codes returned (1-50, default 10)."},"billable_only":{"type":"boolean","description":"When true, only return codes valid for claim submission (excludes category headers)."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"q":"type 2 diabetes","limit":10,"billable_only":true}}},"response":{"data":{"ok":true,"meta":{"mode":"keyword","query":{"q":"type 2 diabetes","code":null,"limit":10,"billableOnly":true},"verified":null,"exactMatch":null,"fiscalYear":2026},"items":[{"code":"E10A2","billable":true,"codeDotted":"E10.A2","longDescription":"Type 1 diabetes mellitus, presymptomatic, Stage 2","shortDescription":"Type 1 diabetes mellitus, presymptomatic, Stage 2"},{"code":"E1100","billable":true,"codeDotted":"E11.00","longDescription":"Type 2 diabetes mellitus with hyperosmolarity without nonketotic hyperglycemic-hyperosmolar coma (NKHHC)","shortDescription":"Type 2 diab w hyprosm w/o nonket hyprgly-hypros coma (NKHHC)"},{"code":"E1101","billable":true,"codeDotted":"E11.01","longDescription":"Type 2 diabetes mellitus with hyperosmolarity with coma","shortDescription":"Type 2 diabetes mellitus with hyperosmolarity with coma"},{"code":"E1110","billable":true,"codeDotted":"E11.10","longDescription":"Type 2 diabetes mellitus with ketoacidosis without coma","shortDescription":"Type 2 diabetes mellitus with ketoacidosis without coma"},{"code":"E1111","billable":true,"codeDotted":"E11.11","longDescription":"Type 2 diabetes mellitus with ketoacidosis with coma","shortDescription":"Type 2 diabetes mellitus with ketoacidosis with coma"},{"code":"E1121","billable":true,"codeDotted":"E11.21","longDescription":"Type 2 diabetes mellitus with diabetic nephropathy","shortDescription":"Type 2 diabetes mellitus with diabetic nephropathy"},{"code":"E1122","billable":true,"codeDotted":"E11.22","longDescription":"Type 2 diabetes mellitus with diabetic chronic kidney disease","shortDescription":"Type 2 diabetes mellitus w diabetic chronic kidney disease"},{"code":"E1129","billable":true,"codeDotted":"E11.29","longDescription":"Type 2 diabetes mellitus with other diabetic kidney complication","shortDescription":"Type 2 diabetes mellitus w oth diabetic kidney complication"},{"code":"E11311","billable":true,"codeDotted":"E11.311","longDescription":"Type 2 diabetes mellitus with unspecified diabetic retinopathy with macular edema","shortDescription":"Type 2 diabetes w unsp diabetic retinopathy w macular edema"},{"code":"E11319","billable":true,"codeDotted":"E11.319","longDescription":"Type 2 diabetes mellitus with unspecified diabetic retinopathy without macular edema","shortDescription":"Type 2 diabetes w unsp diabetic rtnop w/o macular edema"}],"total":null,"source":{"url":"https://www.cms.gov/medicare/coding-billing/icd-10-codes","license":"Public domain (US government work)","provider":"US Centers for Medicare & Medicaid Services (CMS) / NCHS — ICD-10-CM"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"medical.icd10","settlement":{"txHash":"0xb921f77e01fa4a4fe02dfd6c3fbf895be3a892136c26f59cd53e017008a50f13","network":"eip155:8453","success":true}}}},"exampleRequest":{"q":"type 2 diabetes","limit":10,"billable_only":true},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EWSVMNrmI-9ZI0sQk9Nog","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches ICD-10-CM diagnosis codes by keyword or verifies a specific code, returning official descriptions and billability status","exampleAgentPrompt":"Can you verify whether ICD-10 code E11.65 is valid and billable, and also show me any child codes under it — only return billable ones, up to 20 results?","exampleUseCases":null,"resultDescription":"Returns a JSON object with an array of matching ICD-10-CM codes, each including the code without dot, the conventional dotted form, a short description, a long description, and a billable flag. Also includes metadata indicating the query mode (verify or keyword), whether the exact code was verified, the exact match object if found, and the US fiscal year of the loaded code set. Total count of matching records is included.","failureModes":["Both 'code' and 'q' provided simultaneously — API requires exactly one","Code pattern does not match required regex (must start with letter, followed by digits) — validation error","Keyword query shorter than 3 characters — rejected by minLength constraint","No codes found matching the keyword — empty items array returned","Invalid code format — returns not-verified result with null exactMatch","Limit out of range (below 1 or above 50) — schema validation failure"],"whenToPreferThis":"Use this endpoint when you need to look up, search, or validate ICD-10-CM diagnosis codes in a medical, billing, or clinical context. Ideal for verifying a code before claim submission, exploring child codes under a category, or finding codes by symptom/condition keyword. Prefer this over general web search when structured, authoritative, machine-readable ICD-10 data is needed with billability flags.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:53:08.440Z","isFirstParty":false}