API Reference
Complete API Reference
Explore all available endpoints in the MedRef API. All endpoints require authentication via API key.
Base URL
https://api.medref.io/v1
Authentication
Bearer <API_KEY>
Format
JSON
Procedure Codes
| Method | Endpoint |
|---|---|
| GET | /v1/cpt/{code} |
| GET | /v1/cpt/search |
| GET | /v1/hcpcs/{code} |
| GET | /v1/hcpcs/search |
| GET | /v1/modifiers/{code} |
| GET | /v1/modifiers |
Diagnosis Codes
| Method | Endpoint |
|---|---|
| GET | /v1/icd10/cm/{code} |
| GET | /v1/icd10/cm/search |
| GET | /v1/icd10/cm/hierarchy/{code} |
| GET | /v1/icd10/pcs/{code} |
| GET | /v1/icd10/pcs/search |
Medicare Fee Schedules
| Method | Endpoint |
|---|---|
| GET | /v1/medicare/mpfs/{code} |
| GET | /v1/medicare/opps/{code} |
| GET | /v1/medicare/ipps/{drg} |
| GET | /v1/medicare/localities |
| GET | /v1/medicare/conversion-factor |
NCCI Edits
| Method | Endpoint |
|---|---|
| GET | /v1/ncci/edit |
| GET | /v1/ncci/mue/{code} |
| POST | /v1/ncci/validate |
NPI Registry
| Method | Endpoint |
|---|---|
| GET | /v1/npi/{npi} |
| GET | /v1/npi/search |
| GET | /v1/npi/validate/{npi} |
Provider Taxonomy
| Method | Endpoint |
|---|---|
| GET | /v1/taxonomy/{code} |
| GET | /v1/taxonomy/search |
| GET | /v1/taxonomy/hierarchy |
Place of Service
| Method | Endpoint |
|---|---|
| GET | /v1/pos/{code} |
| GET | /v1/pos |
Revenue Codes
| Method | Endpoint |
|---|---|
| GET | /v1/revenue/{code} |
| GET | /v1/revenue/search |
Geocoding
| Method | Endpoint |
|---|---|
| POST | /v1/geocode/address |
| POST | /v1/geocode/distance |
| POST | /v1/geocode/radius |
Error Responses
All errors follow a consistent format with an error code, message, and HTTP status.
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
404Not Found - Resource doesn't exist
429Rate Limited - Too many requests
Ready to get started?
Check out our documentation for detailed examples and guides.