# ICD-10-CM Code Lookup and Verification API

> ICD-10-CM Code Lookup and Verification API is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Searches ICD-10-CM diagnosis codes by keyword or verifies a specific code, returning official descriptions and billability status

## Facts

- Endpoint: GET https://2s.io/api/medical/icd10
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/icd-10-cm-code-lookup-and-verification-api-cdd88147
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__xcx9LAsOZd91nOi39PEa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability icd-10-cm-code-lookup-and-verification-api-cdd88147
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "q": "type 2 diabetes",
   "limit": 10,
   "billable_only": true
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/icd-10-cm-code-lookup-and-verification-api-cdd88147/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)