Core Endpoints

ICD-10-CM/PCS Codes

Access the complete ICD-10-CM (Clinical Modification) diagnosis codes and ICD-10-PCS (Procedure Coding System) with full hierarchy, relationships, and clinical context.

Get a Diagnosis Code

GET/v1/icd10/cm/{code}

curl -X GET "https://api.medref.io/v1/icd10/cm/E11.9" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "code": "E11.9",
  "type": "ICD-10-CM",
  "description": "Type 2 diabetes mellitus without complications",
  "long_description": "Type 2 diabetes mellitus without complications",
  "chapter": "4",
  "chapter_description": "Endocrine, nutritional and metabolic diseases",
  "block": "E08-E13",
  "block_description": "Diabetes mellitus",
  "category": "E11",
  "category_description": "Type 2 diabetes mellitus",
  "billable": true,
  "effective_date": "2024-10-01",
  "hierarchy": {
    "parent": "E11",
    "children": [],
    "related_codes": ["E11.65", "E11.21", "E11.22"]
  },
  "clinical_info": {
    "includes": ["diabetes NOS", "diabetes mellitus due to insulin secretory defect"],
    "excludes1": ["diabetes mellitus due to underlying condition (E08.-)"],
    "use_additional": ["code to identify control using insulin (Z79.4)"
  }
}

Search Diagnosis Codes

GET/v1/icd10/cm/search

curl -X GET "https://api.medref.io/v1/icd10/cm/search?q=diabetes&billable=true&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Parameter	Type	Description
q	string	Search query for code or description
chapter	string	Filter by ICD-10 chapter
billable	boolean	Filter to only billable codes
limit	integer	Max results (default: 20, max: 100)

Browse Hierarchy

GET/v1/icd10/cm/hierarchy/{code}

curl -X GET "https://api.medref.io/v1/icd10/cm/hierarchy/E11" \
  -H "Authorization: Bearer YOUR_API_KEY"

// Returns full hierarchy tree under E11 category

ICD-10-PCS Procedure Codes

Procedure codes follow the same pattern with /v1/icd10/pcs endpoints.

GET/v1/icd10/pcs/{code}

curl -X GET "https://api.medref.io/v1/icd10/pcs/0BJ08ZZ" \
  -H "Authorization: Bearer YOUR_API_KEY"

// Response includes all 7 character axis values with descriptions