API & Developers
387,000+ providers. Real-time scheduling. One API.
Search providers, verify in-network status, and book appointments through a single REST API. Tenant-scoped, rate-limited, and ready for production.
Get your sandbox API key in 30 seconds
Full API access. No credit card required.
Interactive API Playground
Make real API calls. See real responses. Using demo key · Rate limited to 10 req/min · Results are live
Request
Request Preview
GET /v1/physicians/search
{
"specialty": "Cardiology",
"latitude": "36.1627",
"longitude": "-86.7816",
"radius_mi": "25",
"limit": "3"
}Response
Send a request to see the response
curl -X GET "https://api.guidingpatients.com/v1/physicians/search?specialty=Cardiology&latitude=36.1627&longitude=-86.7816&radius_mi=25&limit=3" \ -H "X-API-Key: gp_live_your_key_here" \ -H "Accept: application/json"
API Capabilities
Provider Search
Search by specialty, location, insurance plan, hospital affiliation, NPI, and keywords. Filter by network status, acceptance, and availability.
Appointment Booking
Book directly into provider scheduling systems via secure backend connections. Full confirmation and audit trail.
Eligibility Verification
Verify member insurance coverage, referral requirements, and in-network status before booking.
Reporting & Analytics
Pull booking metrics, care gap status, in-network rates, and utilization data for your tenant.
Developer Experience
Tenant-Scoped Keys
Each organization gets isolated API access. Manage keys through the admin portal.
Sandbox Environment
Test with live provider data in a rate-limited sandbox. No production impact.
Rate Limiting
Per-tenant sliding window with configurable limits. Sandbox: 10 req/min. Production: custom.
Webhooks
Subscribe to booking confirmations, cancellations, and status changes.
SDKs
Python and JavaScript SDKs coming soon for faster integration.
OpenAPI Spec
Full spec available for code generation and tooling integration.
Integration Patterns
Embedded Widget
Drop a scheduling widget into your app. Minimal code, full functionality.
API Integration
Build a fully custom UI powered by GP's data and booking engine.
White Label
Use the full GuidingPatients platform with your brand, your domain, your experience.
Quickstart Guide
Sign up for a sandbox API key
Fill out the form above to get your key. It works immediately.
↑ Scroll to signup formMake your first provider search
Search for cardiologists near Nashville, TN.
curl -X GET "https://api.guidingpatients.com/v1/physicians/search?specialty=Cardiology&latitude=36.1627&longitude=-86.7816&radius_mi=25" \
-H "X-API-Key: gp_live_your_key_here"View provider details
Get the full profile for a specific provider by NPI.
curl -X GET "https://api.guidingpatients.com/v1/physicians/npi/1234567890" \
-H "X-API-Key: gp_live_your_key_here"Book a test appointment
Create a booking request in sandbox mode.
curl -X POST "https://api.guidingpatients.com/v1/appointments/book" \
-H "X-API-Key: gp_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"provider_npi": "1234567890", "patient_name": "Maria Santos", "preferred_time": "2026-04-18T10:30:00"}'Upgrade to production keys
Contact our team to get production API keys with higher rate limits.
Contact us →API Use Cases
Health tech platforms
Embed provider search and scheduling directly into your care management, population health, or referral management product. Skip 12+ months of building provider data infrastructure from scratch.
Payers & MCOs
Power member-facing provider directories with real-time availability and in-network intelligence.
Health systems
Integrate scheduling into your internal tools, patient portals, or discharge planning workflows.
Start building on GuidingPatients.
Sandbox access in 30 seconds. Production keys after review.