Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zocdoc providers API

Endpoints to retrieve providers within the developer's directory.

Zocdoc providers API is one of 10 APIs that Zocdoc publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include providers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a changelog.

This API exposes 2 operations across 2 paths, and defines 22 schemas. It is described by OpenAPI 3.0.0, at version 1.176.

Requests are made against 2 base URLs: https://api-developer-sandbox.zocdoc.com, https://api-developer.zocdoc.com.

2 operations 2 paths 22 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.176
Base URL
https://api-developer.zocdoc.com
Authentication
OAuth 2.0, OAuth 2.0
Resource Areas
1

Authentication & Security 2

Zocdoc providers API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (ClientCredentialsFlow) using the clientCredentials flow, exposing 6 scopes. It supports OAuth 2.0 (AuthorizationCodeFlow) using the authorizationCode flow, exposing 3 scopes.

  • ClientCredentialsFlow — Machine to machine authentication (for use from client server to Zocdoc). Production: https://auth.zocdoc.com/oauth/token Sandbox: https://auth-api-developer-s…
  • AuthorizationCodeFlow — Log in as a user. Client Secret is not necessary for this login flow. Production: https://auth.zocdoc.com Sandbox: https://auth-api-developer-sandbox.zocdoc.com

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

providers 2

Endpoints to retrieve providers within the developer's directory.

GET
/v1/providers
Get providers by NPIs
getProviders 4 params → 200400401403
GET
/v1/providers/{provider_id}/reviews
Get Provider Reviews
getProviderReviews 1 param → 200400401403404

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are BaseProvider (16 properties), BaseLocation (11 properties), ProviderReviewsData (5 properties), BaseProviderDetailsLocation (4 properties). Each schema is shown below with its type and property counts.

BaseResult
object
1 property 1 required
BaseProvider
object
16 properties
ProviderCredentials
object
Provider Credentials include education and certifications.
2 properties 2 required
Error
object
2 properties 1 required
ProviderReviewsResponse
ProvidersByNpi
object
2 properties
Location
Practice
object
2 properties 2 required
ProviderDetails
BaseLocation
object
11 properties 6 required
BookingRequestInsuranceSource
string
The types of insurance coverage that a provider accepts
ErrorResult
ProviderResult
BaseLocationWithDistance
VirtualLocation
ErrorType
string
AcceptsPatientInsuranceType
string
Whether the provider location accepts the patient's insurance
Education
object
1 property
BookingRequirements
object
Criteria for booking appointments, defines requirements and mandatory fields specified by Zocdoc providers
2 properties 2 required
BaseVirtualLocation
object
3 properties 1 required
ProviderReviewsData
object
5 properties 2 required
BaseProviderDetailsLocation
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zocdoc-providers-api-openapi.yml Raw ↑

Other APIs Zocdoc publishes across the network.

Zocdoc appointments API
Zocdoc calendar-integration-timeslots API
Zocdoc credentials API
Zocdoc facilities API
Zocdoc insurance-reference API
Zocdoc provider-locations API
Zocdoc reference API
Zocdoc schedulable-entities API
Zocdoc webhook API