--- title: "Get insurance plans" method: GET path: "/v1/insurance_plans" tags: ["insurance-reference"] --- # Get insurance plans `GET /v1/insurance_plans` ## Request - Base URL: `https://api-developer-sandbox.zocdoc.com` - URL: `https://api-developer-sandbox.zocdoc.com/v1/insurance_plans` - Auth: one of: - OAuth 2 - Client credentials - Token URL: `https://auth.zocdoc.com/oauth/token` - OAuth 2 - Authorization code: `https://auth.zocdoc.com/authorize` - Token URL: `https://auth.zocdoc.com/oauth/token` Get insurance plans ## Query parameters - `page` integer - `page_size` integer - `status` 'inactive' | 'active' | 'deleted': Status of the insurance plan - `state` string - `network_type` 'hmo' | 'ppo' | 'pos' | 'epo' | 'indemnity' | 'aso' | 'aco' | 'acp' | 'medicare' | 'medicaid' | 'other' | 'uncategorized' | 'hmo_pos': 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 - `program_type` 'commercial' | 'commercial_exchange' | 'medicare' | 'medicaid' | 'workers_compensation' | 'uncategorized' | 'medicare_advantage' | 'medicaid_managed_care' | 'federal': 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 - `care_category` 'health' | 'dental' | 'vision': The category of care for an insurance plan * Health: Health and Mental Health Care * Dental: Dental Care * Vision: Vision Care ## Response `200` Success - InsurancePlansResponse - `request_id` string, required: Unique request identifier for tracing - `page` integer, required: The zero based index of the current page. - `page_size` integer, required: The size of the current page. - `total_count` integer, required: The total number of result items. - `next_url` string, required: A link to the next page of results; null if this is the last page of results. - `data` InsurancePlan[], required - `id` string, required: Zocdoc id for insurance plan - `name` string, required - `carrier` InsuranceCarrier, required: The insurance carrier for the insurance plan - `id` string, required: Zocdoc id for insurance carrier - `name` string, required - `network_type` 'hmo' | 'ppo' | 'pos' | 'epo' | 'indemnity' | 'aso' | 'aco' | 'acp' | 'medicare' | 'medicaid' | 'other' | 'uncategorized' | 'hmo_pos', 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 - `program_type` 'commercial' | 'commercial_exchange' | 'medicare' | 'medicaid' | 'workers_compensation' | 'uncategorized' | 'medicare_advantage' | 'medicaid_managed_care' | 'federal', 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 - `status` 'inactive' | 'active' | 'deleted', required: Status of the insurance plan - `care_categories` CareCategory[], required - `coverage_area` CoverageArea, required - `is_national` boolean, required - `states` string[]: The two letter state codes where the insurance plan has coverage. Will be null when is_national true. - `ref_metadata` ReferenceMetadata, required - `created_timestamp_utc` string, date-time: Date & time of when the reference data was made in ISO-8601 format with a timezone offset representing UTC - `last_updated_timestamp_utc` string, date-time: Date & time of when the reference data was last updated in ISO-8601 format with a timezone offset representing UTC - `replacement_plan_id` string: Zocdoc id of the insurance plan this plan was merged into, or null if the plan has not been merged. Update any stored reference to this plan to the replacement id. The id is returned even if the replacement plan is not itself returned by this API. If the replacement plan has its own `replacement_plan_id`, follow it to reach the current plan. ## Other responses - `400`: Invalid request parameters. - `401`: Unauthorized - `403`: Forbidden - `404`: Not found --- [API](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api.md) - [All operations](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/revisions/965a6ca4ed12?raw)