Skip to content
Download OpenAPI description
Languages
Servers
Sandbox

https://api-developer-sandbox.zocdoc.com/

Production

https://api-developer.zocdoc.com/

NPIs

Endpoints to retrieve information about the developer's directory.

Operations

Schedulable entities

Endpoints to retrieve schedulable entities with availability information.

Operations

Insurance

Endpoints to retrieve insurance plans supported by Zocdoc.

Operations

Request

Get insurance plans

Security
ClientCredentialsFlow or AuthorizationCodeFlow
Query
pageinteger[ 0 .. 100 ]

The zero indexed page of results.

Default 0
page_sizeinteger[ 1 .. 500 ]

The number of results to return per page. Default is 100.

Default 100
statusstring(InsuranceStatus)

The status of the insurance plan. Default is active.

Enum"inactive""active""deleted"
statestring

The two letter State code where the insurance plan has coverage.

Example: state=NY
plan_typestring(InsurancePlanType)

The type of insurance plan.

Enum"hmo""ppo""pos""epo""indemnity""aso""aco""acp""medicare""medicaid"
program_typestring(InsuranceProgramType)

The program type of the insurance plan.

Enum"commercial""commercial_exchange""medicare""medicaid""workers_compensation""uncategorized"
care_categorystring(CareCategory)

The care type of the insurance plan.

Enum"health""dental""vision"
curl -i -X GET \
  'https://api-developer-sandbox.zocdoc.com/v1/insurance_plans?page=0&page_size=100&status=inactive&state=NY&plan_type=hmo&program_type=commercial&care_category=health' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
request_idstringrequired
pageintegerrequired

The zero based index of the current page.

page_sizeintegerrequired

The size of the current page.

total_countintegerrequired

The total number of result items.

next_urlstringrequired

A link to the next page of results; null if this is the last page of results.

dataArray of objects(InsurancePlan)required
data[].​idstringrequired

Zocdoc id for insurance plan

data[].​namestringrequired
data[].​carrierobject(InsuranceCarrier)required

The insurance carrier for the insurance plan

data[].​carrier.​idstringrequired

Zocdoc id for insurance carrier

data[].​carrier.​namestringrequired
data[].​plan_typestring(InsurancePlanType)required

The type of insurance plan

  • HMO: Health Maintenance Organization
  • PPO: Preferred Provider Organization
  • POS: Point-of-Service
  • EPO: Exclusive Provider Organization
  • Indemnity: Traditional fee-for-service plans
  • ASO: Administrative Services Only
  • ACO: Accountable Care Organizations
  • ACP: Accountable Care Program
  • Medicare: Medicare Advantage plans
  • Medicaid: Medicaid Managed Care plans
  • Other
  • Uncategorized: Uncategorized insurance plans
Enum"hmo""ppo""pos""epo""indemnity""aso""aco""acp""medicare""medicaid"
data[].​program_typestring(InsuranceProgramType)required

We've categorized plan types offered by each carrier into their associated programs:

  • Commercial: The most common plans offered by private companies. Providers contract directly with the private insurance company.
  • ACA Marketplace (Commercial exchange): Plans available for patients to buy on online marketplaces under the Affordable Care Act. Providers contract with the insurance carrier offering the plan, not the marketplace itself.
  • Medicare: Medicare advantage plans, sometimes called “Part C” or “MA Plans,” are offered by private companies approved by Medicare. They provide coverage to individuals, families, and employer groups, typically through employer-sponsored plans.
  • Medicaid: Medicaid Managed Care plans provide Medicaid benefits through contracted arrangements between state Medicaid agencies and a managed care organization (MCOs).
  • Worker's Compensation: State-mandated programs for work-related injuries and illnesses. Providers contract with the employer or a state-designated agency.
  • Uncategorized: Uncategorized insurance plans
Enum"commercial""commercial_exchange""medicare""medicaid""workers_compensation""uncategorized"
data[].​statusstring(InsuranceStatus)required

Status of the insurance plan

Enum"inactive""active""deleted"
data[].​care_categoriesArray of strings(CareCategory)required
Items Enum"health""dental""vision"
data[].​coverage_areaobject(CoverageArea)required
data[].​coverage_area.​is_nationalbooleanrequired
data[].​coverage_area.​statesArray of strings

The two letter state codes where the insurance plan has coverage. Will be null when is_national true.

data[].​ref_metadataobject(ReferenceMetadata)required
data[].​ref_metadata.​created_timestamp_utcstring(date-time)

Date & time of when the reference data was made in ISO-8601 format with a timezone offset representing UTC

Example: "2022-04-27T09:00:00-00:00"
data[].​ref_metadata.​last_updated_timestamp_utcstring(date-time)

Date & time of when the reference data was last updated in ISO-8601 format with a timezone offset representing UTC

Example: "2022-04-27T09:00:00-00:00"
Response
application/json
{ "request_id": "string", "page": 0, "page_size": 0, "total_count": 0, "next_url": "string", "data": [ {} ] }

Request

Get insurance plan by id.

Security
ClientCredentialsFlow or AuthorizationCodeFlow
Path
insurance_plan_idstringrequired

Zocdoc insurance plan id

Example: ip_2224
curl -i -X GET \
  https://api-developer-sandbox.zocdoc.com/v1/insurance_plans/ip_2224 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
request_idstringrequired
dataobject(InsurancePlan)required
data.​idstringrequired

Zocdoc id for insurance plan

data.​namestringrequired
data.​carrierobject(InsuranceCarrier)required

The insurance carrier for the insurance plan

data.​carrier.​idstringrequired

Zocdoc id for insurance carrier

data.​carrier.​namestringrequired
data.​plan_typestring(InsurancePlanType)required

The type of insurance plan

  • HMO: Health Maintenance Organization
  • PPO: Preferred Provider Organization
  • POS: Point-of-Service
  • EPO: Exclusive Provider Organization
  • Indemnity: Traditional fee-for-service plans
  • ASO: Administrative Services Only
  • ACO: Accountable Care Organizations
  • ACP: Accountable Care Program
  • Medicare: Medicare Advantage plans
  • Medicaid: Medicaid Managed Care plans
  • Other
  • Uncategorized: Uncategorized insurance plans
Enum"hmo""ppo""pos""epo""indemnity""aso""aco""acp""medicare""medicaid"
data.​program_typestring(InsuranceProgramType)required

We've categorized plan types offered by each carrier into their associated programs:

  • Commercial: The most common plans offered by private companies. Providers contract directly with the private insurance company.
  • ACA Marketplace (Commercial exchange): Plans available for patients to buy on online marketplaces under the Affordable Care Act. Providers contract with the insurance carrier offering the plan, not the marketplace itself.
  • Medicare: Medicare advantage plans, sometimes called “Part C” or “MA Plans,” are offered by private companies approved by Medicare. They provide coverage to individuals, families, and employer groups, typically through employer-sponsored plans.
  • Medicaid: Medicaid Managed Care plans provide Medicaid benefits through contracted arrangements between state Medicaid agencies and a managed care organization (MCOs).
  • Worker's Compensation: State-mandated programs for work-related injuries and illnesses. Providers contract with the employer or a state-designated agency.
  • Uncategorized: Uncategorized insurance plans
Enum"commercial""commercial_exchange""medicare""medicaid""workers_compensation""uncategorized"
data.​statusstring(InsuranceStatus)required

Status of the insurance plan

Enum"inactive""active""deleted"
data.​care_categoriesArray of strings(CareCategory)required
Items Enum"health""dental""vision"
data.​coverage_areaobject(CoverageArea)required
data.​coverage_area.​is_nationalbooleanrequired
data.​coverage_area.​statesArray of strings

The two letter state codes where the insurance plan has coverage. Will be null when is_national true.

data.​ref_metadataobject(ReferenceMetadata)required
data.​ref_metadata.​created_timestamp_utcstring(date-time)

Date & time of when the reference data was made in ISO-8601 format with a timezone offset representing UTC

Example: "2022-04-27T09:00:00-00:00"
data.​ref_metadata.​last_updated_timestamp_utcstring(date-time)

Date & time of when the reference data was last updated in ISO-8601 format with a timezone offset representing UTC

Example: "2022-04-27T09:00:00-00:00"
Response
application/json
{ "request_id": "string", "data": { "id": "string", "name": "string", "carrier": {}, "plan_type": "hmo", "program_type": "commercial", "status": "inactive", "care_categories": [], "coverage_area": {}, "ref_metadata": {} } }

Providers

Endpoints to retrieve providers within the developer's directory.

Operations

Provider locations

Endpoints for retrieving and modifying provider location objects and their related reviews, insurance plans, and availability.

Operations

Facilities

Endpoints to retrieve facilities within the developer's directory.

Operations

Calendar integration timeslots

Endpoints to manage timeslots for providers.

Operations

Appointments

Endpoints for booking, cancelling, and rescheduling appointments, including retrieving current appointment statuses and updated information.

Operations

Webhook

Sandbox endpoints to mock webhook behavior

Operations