ICD-10-CM Coding API — Code lookup, AI-powered chart review, HCC risk adjustment, and multi-platform integrations. Built for EHR developers, AI agents, and health tech teams.
Every code returned is a valid code in the official ICD-10-CM code set for the fiscal year you request. Made-up codes can't get through.
AI chart review, natural-language coding to codes valid in the official code set, and abbreviation expansion.
MCP server, OpenAI function calling, and Anthropic tool_use integrations. Give any AI agent medical coding intelligence.
Database-verified ICD-10-CM data with smart search, abbreviation expansion, and batch operations.
Full ICD-10-CM tabular data — descriptions, includes/excludes notes, instructional notes, billable status, and chapter/section hierarchy.
Dual-mode search — alphabetic index navigation plus tabular fuzzy search with typeahead autocomplete.
Medical shorthand to standard terms — e.g., “DM2” expands to “diabetes mellitus type 2” with mapped ICD-10 codes.
Bulk code lookups (up to 50 codes/request), bulk HCC summaries, and hierarchy suppression with RAF score calculation.
AI coding results grounded in official CMS data, with the supporting evidence attached.
Send a clinical description as natural language or as an uploaded document and get ICD-10-CM codes grounded in official CMS ICD-10-CM data, each linked to its supporting evidence. Codes that are not valid in the official code set are never returned.
Results come back the way coders work: codes, descriptions and the evidence behind each one, and every code returned is a valid, billable ICD-10-CM code. Results are for review by a credentialed coder.
The evidence trail shows the source text behind every code and the official guidance applied. Audit-ready for compliance review.
AI coding accepts clinical input as natural language text or uploaded documents in 16 formats — PDF, DOCX, HL7, C-CDA, FHIR, images, spreadsheets, and more. Each condition documented in it is coded to ICD-10-CM.
Every code returned is a valid, billable code in the official ICD-10-CM code set for the fiscal year you request. Each result comes with a confidence score and a verification report that flags any ICD-10-CM coding-convention issue for the coder to resolve.
Upload medical documents and get the conditions they document coded to ICD-10-CM.
Upload PDF, DOCX, images, spreadsheets, HL7, C-CDA, and FHIR documents. Max 20 MB per document; up to 500 pages parsed.
Get the demographics, conditions, medications, surgical history and providers in each uploaded document as structured data.
Each documented condition is coded to ICD-10-CM. Includes FDA drug indication matching.
Submit a document via POST /api/v1/chart-review/upload to receive a job ID, then poll GET /api/v1/chart-review/{job_id} for results. OCR support for scanned documents and images.
Comprehensive risk adjustment across all major CMS models with hierarchy suppression and RAF scoring.
CMS-HCC (V22, V24, V28), CMS-HCC ESRD (V21, V24), RxHCC (V08) and HHS-HCC (V08 — ACA marketplace) models.
Per-segment weights (community nondual/dual aged/disabled, institutional) with payment year filtering.
Auto-applies CMS suppression rules, returns active vs. suppressed categories with total RAF score.
Connect from any platform — REST, MCP, OpenAI, or Anthropic.
Standard JSON endpoints with OpenAPI documentation. Simple, predictable, and well-documented.
Native integration with Claude, Cursor, Windsurf, and any MCP-compatible agent.
Function calling schema available at /tools/openai.
tool_use schema available at /tools/anthropic.
Simple REST API. JSON responses. Get started in minutes.
$ curl https://api.accurecord.io/api/v1/codes/E11.9 \
-H "Authorization: Bearer YOUR_API_KEY"
// Response
{
"code": "E11.9",
"description": "Type 2 diabetes mellitus without complications",
"category": "E11",
"chapter": "4",
"is_billable": true,
"hcc_mappings": {
"v28": { "hcc": "38", "label": "Diabetes with Glycemic, Unspecified, or No Complications" },
"v24": { "hcc": "19", "label": "Diabetes without Complication" }
}
}Every AI coding response includes a verification report.
{
"codes": [
{ "code": "E11.9", "description": "Type 2 diabetes mellitus without complications" }
],
"verification": {
"confidence_score": 0.92,
"codes_not_returned": [],
"codes_added": []
}
}| Status | Meaning | Common Cause |
|---|---|---|
401 |
Unauthorized | Invalid or missing API key |
403 |
Forbidden | Feature not available on your tier |
429 |
Too Many Requests | Rate limit exceeded — check Retry-After header |
503 |
Service Unavailable | Temporary outage — retry with exponential backoff |
HIPAA-aligned security controls built into every layer of the API.
Encryption, audit logging, access controls, data retention, and the minimum necessary principle. Customer-directed deletion of the coding data held under your API keys, from your signed-in account (DELETE /api/v1/billing/data, with an explicit confirmation); audit and disclosure logs are retained.
Security headers, config validation, anomaly detection, structured logging, and health monitoring. No SOC 2 report has been issued.
Two auth methods; keys are created from your account on a paid tier.
Authorization: Bearer <key>
X-API-Key: <key>
icd10_ prefix + 64 hex characters
$ curl https://api.accurecord.io/api/v1/codes/E11.9 \
-H "Authorization: Bearer icd10_a1b2c3d4..."| Spec | Value |
|---|---|
| Base URL | https://api.accurecord.io/api/v1 |
| Protocol | HTTPS (TLS 1.2+) |
| Auth | Bearer token or X-API-Key header |
| Format | JSON request/response |
| ICD-10 Year | Current ICD-10-CM fiscal year (advances each Oct 1; FY2027 since 2026-10-01), configurable per request |
| Chart formats | PDF, DOCX, TXT, RTF, CSV, XLSX, XLS, XML (C-CDA), JSON (FHIR), HL7v2, PNG, JPG, TIFF, BMP, HEIC, WEBP |
| Encryption | AES-256-GCM (at rest), TLS (in transit) |
| Scale | Asynchronous processing — up to 3 chart-review jobs running at once per API key |
Explore plans and start building with the ICD-10 Coding API.
Pricing, PHI, HCC, and AI-agent support.
Not at the moment: new free API keys are paused and existing free keys are inactive. Pro and Enterprise tiers add AI coding and batch operations and are BAA-eligible: PHI is permitted only for a healthcare organization once a Business Associate Agreement has been executed with it, never on an individual account. Contact [email protected] for a key.
Yes. Alongside ICD-10-CM lookups, the API returns HCC mappings across risk-adjustment models, so you can surface risk-adjustment-relevant codes programmatically.
Yes. The API ships an MCP server plus OpenAI- and Anthropic-compatible tool definitions, so AI agents can call ICD-10 lookup and coding tools directly.
A free tier, when offered, is reference-only and not intended for PHI. The Pro and Enterprise tiers are BAA-eligible, and handle PHI only for a healthcare organization under a Business Associate Agreement (BAA) executed with that organization. PHI is never enabled by self-serve signup and is not available on individual accounts.