API Documentation

Complete reference guide for the ProcedureRadar REST API. All endpoints, parameters, and response formats documented below.

OpenAPI Spec Postman Collection

Authentication Procedures Pricing Hospitals

Authentication

The ProcedureRadar API uses Bearer token authentication. Include your API key in the Authorization header for all requests.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.procedureradar.com/v1/procedures

Replace YOUR_API_KEY with your actual API key. Get your key from the dashboard.

Base URL

https://api.procedureradar.com/v1

Procedures

List Procedures

GET /procedures

Retrieve a list of available procedures. Supports filtering and pagination.

Query Parameters:

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Results per page (default: 20, max: 100)
search	string	Search term for procedure name
category	string	Filter by procedure category

Example Request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.procedureradar.com/v1/procedures?limit=10&search=knee

Example Response:

{
  "data": [
    {
      "id": "proc_123",
      "name": "Knee Replacement",
      "category": "Orthopedic",
      "hcpcs_codes": ["27447"],
      "description": "Total knee replacement procedure"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 150,
    "pages": 15
  }
}

Get Procedure Details

GET /procedures/{{id}}}

Get detailed information about a specific procedure.

Pricing

Retrieve pricing data for procedures across locations and providers.

GET /pricing

Query Parameters:

Parameter	Type	Required
procedure_id	string	Yes
metro	string	No
hospital_id	string	No
insurance_plan	string	No

Error Handling

The API returns standard HTTP status codes to indicate success or failure.

200Success

400Bad Request - Invalid parameters

401Unauthorized - Missing or invalid API key

404Not Found - Resource does not exist

429Too Many Requests - Rate limit exceeded

500Server Error

Rate Limiting

API requests are rate limited based on your subscription plan. Rate limit information is included in response headers.

Rate Limit Headers:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1616000000