Core Endpoints

HCPCS & CPT Codes

Search and retrieve Healthcare Common Procedure Coding System (HCPCS) and Current Procedural Terminology (CPT) codes with descriptions, modifiers, and effective dates.

Get a Code

GET/v1/cpt/{code}

curl -X GET "https://api.medref.io/v1/cpt/99213" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "code": "99213",
  "type": "CPT",
  "description": "Office or other outpatient visit for the evaluation and management of an established patient",
  "short_description": "Office/outpatient visit est",
  "category": "Evaluation and Management",
  "effective_date": "2024-01-01",
  "status": "active",
  "rvu": {
    "work": 1.30,
    "practice_expense": 1.46,
    "malpractice": 0.10,
    "total": 2.86
  },
  "modifiers": ["25", "59", "76", "77"]
}

Search Codes

GET/v1/cpt/search

curl -X GET "https://api.medref.io/v1/cpt/search?q=office+visit&category=E/M&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Parameter	Type	Description
q	string	Search query for code or description
category	string	Filter by category (e.g., E/M, Surgery)
limit	integer	Max results (default: 20, max: 100)
offset	integer	Pagination offset

Get Modifiers

GET/v1/modifiers/{code}

curl -X GET "https://api.medref.io/v1/modifiers/25" \
  -H "Authorization: Bearer YOUR_API_KEY"

// Response
{
  "code": "25",
  "description": "Significant, separately identifiable E/M service by the same physician on the same day",
  "applies_to": ["E/M codes"],
  "payment_impact": "Allows separate payment for E/M service"
}