Authentication

All API requests require an X-API-Key header.

curl -H "X-API-Key: gp_live_your_key_here" \
  https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/search?q=smith

API keys use the format gp_live_<32 hex chars>. Keep your key secret.

Endpoints

Physician Search

Method	Endpoint	Description
GET	/v1/physicians/search	Search physicians with filters (q, specialty, state, city, lat/lng/radius, insurance, aco)
GET	/v1/physicians/{npi}	Full physician detail by NPI (locations, insurance, booking options)
GET	/v1/physicians/autocomplete	Fast typeahead search (returns name, NPI, specialty)
GET	/v1/physicians/stats	Database statistics (total physicians, NPI coverage, multi-source count)

Filter Options

Method	Endpoint	Description
GET	/v1/specialties	List all specialties for dropdown filters
GET	/v1/insurance-carriers	List all insurance carriers
GET	/v1/acos	List all Accountable Care Organizations

Booking & Network

Method	Endpoint	Description
POST	/v1/booking/events	Track a booking click-through event
POST	/v1/network/match	Match a list of NPIs against your tenant network
GET	/v1/network	List your tenant's in-network physicians

Reports

Method	Endpoint	Description
GET	/v1/reports/dashboard	Dashboard metrics (booking events, top physicians, utilization)
GET	/v1/reports/export/pdf	Export report as PDF
GET	/v1/reports/export/csv	Export report as CSV

Rate Limiting

Default: 120 requests per minute per API key.

Rate limit headers are included in every response:

X-RateLimit-Limit — your per-minute limit
X-RateLimit-Remaining — requests remaining in current window
X-RateLimit-Reset — seconds until window resets

Need higher limits? Contact info@guidingpatients.com.

Code Examples

curl

# Search for cardiologists in New York
curl -H "X-API-Key: YOUR_KEY" \
  "https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/search?specialty=Cardiology&state=NY"

# Get physician detail by NPI
curl -H "X-API-Key: YOUR_KEY" \
  "https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/1234567890"

# Geo search: physicians within 10 miles of Manhattan
curl -H "X-API-Key: YOUR_KEY" \
  "https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/search?lat=40.7128&lng=-74.0060&radius=10"

Python

import requests

API_KEY = "gp_live_your_key_here"
BASE = "https://wak2mya30e.execute-api.us-east-1.amazonaws.com"

response = requests.get(
    f"{BASE}/v1/physicians/search",
    headers={"X-API-Key": API_KEY},
    params={"q": "smith", "specialty": "Cardiology", "state": "NY"},
)
data = response.json()
for doc in data["results"]:
    print(f"{doc['name']} — {doc['specialty']} — NPI: {doc['npi']}")

JavaScript

const API_KEY = "gp_live_your_key_here";
const BASE = "https://wak2mya30e.execute-api.us-east-1.amazonaws.com";

const res = await fetch(
  `${BASE}/v1/physicians/search?q=smith&state=NY`,
  { headers: { "X-API-Key": API_KEY } }
);
const { results, total } = await res.json();
console.log(`Found ${total} physicians`);
results.forEach(doc =>
  console.log(`${doc.name} — ${doc.specialty}`)
);

Share This Page

Build with GuidingPatients API