# NLM ICD-10-CM Diagnosis Code Search

> NLM ICD-10-CM Diagnosis Code Search is a paid API for AI agents from nlm-icd10cm-code-search.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Converts free-text medical condition descriptions into ranked ICD-10-CM diagnosis code candidates using the NLM Clinical Tables API.

## Facts

- Endpoint: POST https://nlm-icd10cm-code-search.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nlm-icd-10-cm-diagnosis-code-search-3e2a2aa9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MBLu6XnkUBPijsP55JzZm

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 nlm-icd-10-cm-diagnosis-code-search-3e2a2aa9 -d '<json body>'
```

Example prompt: Search the NLM ICD-10-CM database for diagnosis codes matching 'type 2 diabetes with diabetic chronic kidney disease' and return the top 5 results.

## When to prefer this

Prefer this endpoint when an agent needs to map free-text clinical conditions to ICD-10-CM codes in real time within a medical coding, claims processing, or clinical documentation workflow. It is ideal for agent-to-agent pipelines that require ranked code candidates rather than a single deterministic lookup, and when the underlying NLM Clinical Tables authoritative source is preferred. Choose this over general-purpose LLM code guessing when auditability and NLM provenance are required.

## Known failure modes

- Empty or ambiguous search term returns zero results or irrelevant codes
- Misspelled condition names may yield no matches or poor ranking
- Very broad terms (e.g. 'pain') return hundreds of results requiring refinement via maxList
- NLM upstream API unavailability causes downstream failure
- Requesting maxList beyond supported limits may be silently capped or error

## How this service works

Returns matching ICD-10-CM diagnosis codes and descriptions from NLM Clinical Tables clinicaltables.nlm.nih.gov/api/icd10cm for a search term. Autonomous agents and agent-to-agent (A2A) medical-coding, claims and clinical-documentation pipelines use it to convert free-text conditions into billable ICD-10 codes. Ranking surface: condition text to ranked code candidates. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns a JSON object with an 'ok' status flag, a list of ranked ICD-10-CM code-description pairs (each with a 'code' and 'name' field), and a total_results count indicating how many matching codes exist in the NLM database. Provenance metadata identifies the upstream NLM Clinical Tables source URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sf": {
   "type": "string",
   "description": "sf"
  },
  "terms": {
   "type": "string",
   "description": "terms"
  },
  "maxList": {
   "type": "integer",
   "description": "maxList"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "nlm-icd10cm-code-search",
  "result": {
   "results": [
    {
     "code": "E",
     "name": "2"
    },
    {
     "code": "N",
     "name": "2"
    }
   ],
   "total_results": 481
  },
  "provenance": {
   "url": "https://clinicaltables.nlm.nih.gov/api/icd10cm/v3/search",
   "source": "NLM ICD-10-CM Diagnosis Code Search"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nlm-icd-10-cm-diagnosis-code-search-3e2a2aa9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nlm-icd10cm-code-search.hergertsynthora.com](https://www.zero.xyz/host/nlm-icd10cm-code-search.hergertsynthora.com/llms.txt)