MedRefMedRef
Getting Started

Authentication

All API requests require authentication using an API key. Your key identifies your application and enables rate limiting and usage tracking.

API Key Authentication

Include your API key in the Authorization header of every request:

HTTP Header
Authorization: Bearer YOUR_API_KEY

Example Request

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

Managing API Keys

You can create and manage multiple API keys from your dashboard. We recommend using separate keys for development and production environments.

  • Create up to 10 API keys per account
  • Set custom names for easy identification
  • Revoke keys instantly if compromised
  • View usage statistics per key

Error Responses

Authentication errors return a 401 status code:

Response
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "status": 401
  }
}