Developer API

ICD-10 Coding Intelligence for Developers & AI

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.

Database-Verified

Every code response is verified against the official CMS ICD-10-CM database. Hallucinated codes are automatically detected and removed.

AI-Powered

AI chart review, natural language coding with a mandatory 5-step verification workflow, and abbreviation expansion.

AI-Native

MCP server, OpenAI function calling, and Anthropic tool_use integrations. Give any AI agent medical coding intelligence.

Core API Capabilities

Database-verified ICD-10-CM data with smart search, abbreviation expansion, and batch operations.

Code Lookup

Full ICD-10-CM tabular data — descriptions, includes/excludes notes, instructional notes, billable status, and chapter/section hierarchy.

Smart Search

Dual-mode search — alphabetic index navigation plus tabular fuzzy search with typeahead autocomplete.

Abbreviation Expansion

Medical shorthand to standard terms — e.g., “DM2” expands to “diabetes mellitus type 2” with mapped ICD-10 codes.

Batch Operations Pro+

Bulk code lookups (up to 50 codes/request), bulk HCC summaries, and hierarchy suppression with RAF score calculation.

AI-Powered Coding Pro+

Evidence-based AI that follows the actual medical coder workflow — index terms, tabular verification, guideline checks — grounded in official CMS data.

Evidence-Based AI Coding

Clinical descriptions — whether typed as natural language or extracted from uploaded documents — are coded through a structured, evidence-based process grounded in official CMS ICD-10-CM data. Our post-LLM verification engine automatically detects and removes invalid codes.

Actual Coder Workflow

Mirrors how real medical coders work: look up index terms, navigate to the tabular listing, review includes/excludes notes and instructional guidelines, verify specificity level, and check for combination codes. Every step queries the official CMS database — fully traceable.

Full Audit Trail

The evidence trail shows which index entries matched, which tabular notes applied, the specificity and combination checks performed, and exactly why a specific code was selected. Audit-ready for compliance review.

18 Medical Document Formats

AI coding accepts clinical input as natural language text or uploaded documents in 18 formats — PDF, DOCX, HL7, C-CDA, FHIR, images, spreadsheets, and more. Each extracted condition runs through the same 5-step coding agent.

Post-LLM Verification Engine

Every AI-coded result passes through a deterministic verification engine that checks codes against the CMS database, detects conflicts, validates sequencing, and produces an objective confidence score — replacing LLM self-assessment with verified accuracy.

Chart Review Pro+

Upload medical documents and get AI-extracted conditions auto-coded to ICD-10.

18 Document Formats

Upload PDF, DOCX, images, spreadsheets, HL7, C-CDA, and FHIR documents. Max 20 MB, 50 pages per document.

AI Data Extraction

Extracts demographics, conditions, medications, surgical history, and providers from uploaded documents.

Auto-Coding

Each extracted condition is auto-coded to ICD-10 using the same 5-step verification agent. Includes FDA drug indication matching.

Async Processing

Submit a document via POST /api/v1/chart-review to receive a job ID, then poll GET /api/v1/chart-review/{job_id} for results. OCR support for scanned documents and images.

HCC / Risk Adjustment

Comprehensive risk adjustment across all major CMS models with hierarchy suppression and RAF scoring.

5 Risk-Adjustment Models

CMS-HCC V24, CMS-HCC V28, RxHCC, HHS-HCC (ACA marketplace), and ESRD models.

RAF Weights

Per-segment weights (community nondual/dual aged/disabled, institutional) with payment year filtering.

Hierarchy Suppression

Auto-applies CMS suppression rules, returns active vs. suppressed categories with total RAF score.

Multi-Platform Integrations

Connect from any platform — REST, MCP, OpenAI, or Anthropic.

REST API

Standard JSON endpoints with OpenAPI documentation. Simple, predictable, and well-documented.

MCP Server

Native integration with Claude, Cursor, Windsurf, and any MCP-compatible agent.

OpenAI Tools

Function calling schema available at /tools/openai.

Anthropic Tools

tool_use schema available at /tools/anthropic.

Built for Developers

Simple REST API. JSON responses. Get started in minutes.

Terminal
$ curl https://api.accurecord.io/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": "37", "label": "Diabetes with No or Unspecified Complications" },
    "v24": { "hcc": "19", "label": "Diabetes without Complication" }
  }
}

Verified AI Coding Response

Every AI coding response includes a deterministic verification object.

AI Coding Response (excerpt)
{
  "codes": [
    { "code": "E11.9", "description": "Type 2 diabetes mellitus without complications" }
  ],
  "verification": {
    "confidence_score": 0.92,
    "all_codes_verified": true,
    "conflicts_detected": 0
  }
}

Error Codes

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

Security & Compliance

HIPAA-aligned security controls built into every layer of the API.

Encryption

  • AES-256-GCM at rest
  • Fernet key rotation
  • Encrypted file storage
  • Secure file deletion (DoD-style wipe)
  • TLS/HTTPS in transit

PHI Safeguards

  • Auto PHI scrubbing before LLMs
  • SSNs, MRNs, phone, email, addresses, DOBs stripped
  • No PHI in logs
  • Data classification headers on every response

Access Control

  • API key auth with SHA-256 hashed storage
  • Keys shown once at creation
  • Tier-based feature gating
  • Auth anomaly detection with IP blocking
  • Redis sliding window rate limiting

Audit Trail

  • Full HIPAA-aligned audit log
  • Create, read, delete, export actions
  • Tracks API key, resource, request ID
  • IP address and timestamp
  • PHI-accessed flag per entry

Data Retention

  • 90-day auto purge of chart review jobs
  • 365-day coding trace retention
  • 90-day cache retention
  • 30-min stale job reaper
  • 60-min upload cleanup
  • Retention policy with audit trail

Infrastructure

  • Circuit breaker on external calls
  • Per-stage pipeline timeouts
  • Security headers (HSTS, CSP, nosniff)
  • Startup config validation

Compliance Status

HIPAA Controls

Encryption, audit logging, access controls, PHI scrubbing, data retention, and minimum necessary principle. Right-to-deletion via DELETE /api/v1/billing/data.

SOC 2 Controls

Security headers, config validation, anomaly detection, structured logging, and health monitoring.

Authentication

Two auth methods, self-serve signup, and Pro upgrade via Stripe.

Auth Methods

  • Authorization: Bearer <key>
  • X-API-Key: <key>

Key Details

  • Format: icd10_ prefix + 64 hex characters
  • Keys shown once at creation — store securely
  • Self-serve signup at POST /api/v1/billing/signup
  • Pro upgrade via Stripe checkout
Auth Header
$ curl https://api.accurecord.io/api/v1/codes/E11.9 \
  -H "Authorization: Bearer icd10_a1b2c3d4..."

Technical Specs

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 FY2025 (default, 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 Built for millions of charts — async pipeline with batch processing

Pricing

Free

$0 /month
  • 100 requests/day · 10 req/min
  • Code Lookup & Search
  • HCC Mappings
  • Abbreviation Expansion
  • MCP / OpenAI / Anthropic tools
Free signups paused
Most Popular

Pro

$99 /month
  • 10,000 requests/day · 100 req/min
  • AI Coding & Abbreviation Expansion
  • Batch Operations (50 codes/req)
  • Chart Review (18 formats)
  • MCP / OpenAI / Anthropic tools
  • Priority Support
Start Free Trial

Enterprise

Custom
  • Unlimited requests · 500 req/min
  • All Pro features
  • Custom SLA
  • Dedicated Support
Contact Sales

Ready to Build with ICD-10 Intelligence?

Explore plans and start building with the ICD-10 Coding API.

ICD-10 Coding API — FAQ

Pricing, PHI, HCC, and AI-agent support.

Is there a free ICD-10 API?

Yes. The ICD-10 Coding API has a free, reference-only tier (no PHI) for ICD-10-CM code lookup. Paid Pro and Enterprise tiers add higher limits, AI coding, and batch operations, and are BAA-eligible for PHI. Get a key at accurecord.io/get-api-key.

Does the ICD-10 Coding API support HCC and risk adjustment?

Yes. Alongside ICD-10-CM lookups, the API returns HCC mappings across risk-adjustment models, so you can surface risk-adjustment-relevant codes programmatically.

Can I use the ICD-10 Coding API with AI agents (MCP)?

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.

Is the ICD-10 Coding API HIPAA compliant?

The free tier is reference-only and is not intended for PHI. The Pro and Enterprise tiers are BAA-eligible and handle PHI under an executed Business Associate Agreement (BAA).