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 insurance-reference API

Endpoints to retrieve insurance plans supported by Zocdoc.

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

Tagged areas include insurance-reference. 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 15 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 15 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 insurance-reference 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.

insurance-reference 2

Endpoints to retrieve insurance plans supported by Zocdoc.

GET
/v1/insurance_plans
Get insurance plans
getInsurancePlans 7 params → 200400401403404
GET
/v1/insurance_plans/{insurance_plan_id}
Get insurance plan by id
getInsurancePlan 1 param → 200400401403404

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are InsurancePlan (9 properties), ReferenceMetadata (2 properties), Error (2 properties), InsuranceCarrier (2 properties). Each schema is shown below with its type and property counts.

ErrorType
string
InsurancePlan
object
9 properties 9 required
BaseResult
object
1 property 1 required
PaginatedBaseResult
InsuranceCarrier
object
The insurance carrier for the insurance plan
2 properties 2 required
InsurancePlanByIdResponse
object
InsuranceProgramType
string
We've categorized plan types offered by each carrier into their associated programs: Commercial: The most common plans offered by private companies. Providers…
CoverageArea
object
2 properties 1 required
ErrorResult
CareCategory
string
The category of care for an insurance plan Health: Health and Mental Health Care Dental: Dental Care Vision: Vision Care
Error
object
2 properties 1 required
ReferenceMetadata
object
2 properties
InsuranceNetworkType
string
The type of insurance plan HMO: Health Maintenance Organization PPO: Preferred Provider Organization POS: Point-of-Service EPO: Exclusive Provider Organization…
InsurancePlansResponse
object
InsuranceStatus
string
Status of the insurance plan

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zocdoc-insurance-reference-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 provider-locations API
Zocdoc providers API
Zocdoc reference API
Zocdoc schedulable-entities API
Zocdoc webhook API