# ICD-10-CM Diagnosis Code Search

> ICD-10-CM Diagnosis Code Search is a paid API for AI agents from medical-codes.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Search ICD-10-CM diagnosis codes by keyword or phrase and return matching codes with their descriptions and chapters.

## Facts

- Endpoint: GET https://medical-codes.x402tookit.com/icd10-search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/icd-10-cm-diagnosis-code-search-2ef36d34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4A-UUY4W7YCfbcDvVQqOG

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-diagnosis-code-search-2ef36d34
```

Example prompt: Search ICD-10-CM diagnosis codes for 'type 2 diabetes with kidney complications' and return the top 15 matching codes with their descriptions and chapters.

## When to prefer this

Use this endpoint when you need to search ICD-10-CM codes by natural language description keywords rather than looking up a specific known code. Ideal for billing automation, EHR pre-population, clinical documentation assistance, or any workflow where a diagnosis term needs to be mapped to one or more ICD-10-CM codes. Prefer this over exact-code lookup endpoints when the user knows the condition name but not the specific code.

## Known failure modes

- No matching codes found for an ambiguous or misspelled query
- Query too vague returns unrelated codes
- Limit parameter outside 1-25 range may cause validation error
- Degraded mode may return partial results with a degraded flag set to true
- Missing required 'q' parameter returns an error

## How this service works

Search ICD-10-CM diagnosis codes by words in the description, with the matching codes and their chapters.

## Output

Returns a list of matching ICD-10-CM diagnosis codes, each with the code string, official description, and chapter number. Also includes total match count, the number shown, query echo, data source, and an optional summary. Result count is configurable from 1 to 25 (default 10).

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Diagnosis words, e.g. type 2 diabetes"
      },
      "limit": {
       "type": "integer",
       "description": "Results 1 to 25 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "codes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "code": {
          "type": [
           "null",
           "string"
          ]
         },
         "chapter": {
          "type": [
           "null",
           "number"
          ]
         },
         "description": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "query": {
       "type": [
        "null",
        "string"
       ]
      },
      "shown": {
       "type": [
        "null",
        "number"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "totalM
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/icd-10-cm-diagnosis-code-search-2ef36d34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from medical-codes.x402tookit.com](https://www.zero.xyz/host/medical-codes.x402tookit.com/llms.txt)