Use this page to quickly find answers and jump into the right guide.
How do I authenticate with the API?
See the full guide in Authentication and Access Tokens. It covers client credentials, Authorization Code with PKCE, and the Anonymous User Flow.
What base URL should I use?
- Sandbox:
https://api-developer-sandbox.zocdoc.com/ - Production:
https://api-developer.zocdoc.com/
Tokens are environment-specific. Use sandbox credentials and tokens with the sandbox base URL.
Relevant if you are building an application that operates on behalf of patients to let them search for providers, determine live provider availability, book appointments, and manage those appointments.
Can I use Zocdoc's API to search for providers that accept a specific insurance, like Cigna or Aetna? Yes. Zocdoc's Booking and Availability APIs allow developers to build experiences that mimic those on zocdoc.com, including searching for nearby providers that accept a patient's insurance, identifying which providers are accepting new patients and when, and booking with a selected provider.
Can I use Zocdoc's API simply to search for providers and availability, but still book on zocdoc.com? Yes. You can redirect users to complete booking on zocdoc.com after they select a specific timeslot in your application. The timeslot response includes a booking_url for this purpose. Note: this is only appropriate for certain use cases and partnership arrangements.
How do I find availability and book an appointment?
Follow the end-to-end flow in Find Availability and Book Appointments.
How do I reschedule or cancel an appointment?
- Reschedule: Reschedule Appointments
- Cancel: Cancel Appointments
Relevant if you are building an application that operates on behalf of providers/practices.
How do I update accepted insurance offerings?
See Update Insurance Offerings.
How do I create or manage timeslots?
See Create Timeslots for publishing availability.
How do I manage appointments? See appointment management actions in Appointment Actions.
Is there test data I can use?
Yes. See API Endpoint Test Scenarios for safe, repeatable test cases.
How do I use the anonymous user flow for public search?
Use the Anonymous User Flow to let users search providers or locations without logging in.
How do webhooks work and how do I validate them?
See Webhooks for event types, signatures, retries, and validation steps.
I’m getting 401/403 errors. What should I check?
- Token is present and not expired
- Token environment matches the base URL
- Required scopes are granted for the operation
Where is the full API reference?
Open the API Documentation for endpoints, schemas, and examples.
If you don’t see your question here, check the related guide above or the changelog for recent updates.