Developer Documentation

Build with Healthcare Price Data

Access negotiated rates, provider information, and market intelligence through our powerful REST API. Built for healthcare analytics, price transparency tools, and provider networks.

Request API Access

Comprehensive Data

Access millions of negotiated rates from major insurers including UHC, Cigna, Aetna, BCBS, and Optum across all 50 states.

Lightning Fast

Sub-200ms response times powered by cloud-native infrastructure. 99.9% uptime SLA for enterprise customers.

Enterprise Security

API key authentication with bcrypt hashing. Rate limiting protects both you and the platform.

Pricing Plans

Access Tiers

Choose the plan that fits your needs. Contact us for custom enterprise solutions.

Base

For evaluation & small projects

  • 100 requests/day
  • 10 requests/minute
  • 10 NPIs per batch request
  • 50 max results per search
  • All endpoints included
Request Access
MOST POPULAR

Premium

For production applications

  • 10,000 requests/day
  • 100 requests/minute
  • 10 NPIs per batch (all endpoints)
  • 500 max results per search
  • Priority support
Contact Sales
Getting Started

Quick Start Guide

Get up and running in minutes

1

Get your API key

Contact us to request API access. We'll provision your key within 24 hours.

2

Add the header

Include X-API-Key in your request headers for authentication.

3

Start querying

Access provider rates, NPI details, and market data instantly.

# Single NPI lookup
curl -X GET "https://api.med-reveal.com/api/v1/npis/1234567890" \
  -H "X-API-Key: your_api_key_here"

# Batch NPI lookup (max 10)
curl -X POST "https://api.med-reveal.com/api/v1/npis" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "npis": ["1234567890", "0987654321", "1122334455"]
  }'
Reference

API Endpoints

Complete reference of available endpoints

For detailed documentation, request bodies, and response schemas, visit our interactive API docs.

Data Types

Models

Reference guide for all field types and their valid values used across API endpoints

Response Structure

Response Format

All responses follow a consistent JSON structure

Example Response
{
  "success": true,
  "data": {
    "npi": "1234567890",
    "name": "John Smith, MD",
    "state": "TX",
    "city": "Houston",
    "zipcode": "77001",
    "primaryTaxonomyCode": "207Q00000X",
    "tinValue": "123456789",
    "entityTypeCode": 1
  },
  "meta": {
    "requestId": "abc-123-def",
    "timestamp": "2025-01-04T12:00:00Z",
    "role": "BASE",
    "dailyLimit": 100,
    "remainingToday": 87,
    "processingTime": "123ms"
  }
}

// Batch response format:
{
  "success": true,
  "data": [
    {
      "npi": "1234567890",
      "name": "John Smith, MD",
      "state": "TX",
      "city": "Houston",
      "zipcode": "77001",
      "primaryTaxonomyCode": "207Q00000X",
      "tinValue": "123456789",
      "entityTypeCode": 1
    }
  ],
  "meta": {
    "requestId": "abc-123-def",
    "timestamp": "2025-01-04T12:00:00Z",
    "role": "BASE",
    "dailyLimit": 100,
    "remainingToday": 86,
    "processingTime": "234ms"
  },
  "found": 1,
  "notFound": ["0987654321"]
}
Get Started Today

Ready to build with healthcare data?

Contact us to request API access and start building with healthcare price transparency data.