# Get insurance plan by id

Get insurance plan by id.

Endpoint: GET /v1/insurance_plans/{insurance_plan_id}
Version: 1.22
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Path parameters:

  - `insurance_plan_id` (string, required)
    Zocdoc insurance plan id
    Example: "ip_2224"

## Response 200 fields (application/json):

  - `request_id` (string, required)

  - `data` (object, required)

  - `data.id` (string, required)
    Zocdoc id for insurance plan

  - `data.name` (string, required)

  - `data.carrier` (object, required)
    The insurance carrier for the insurance plan

  - `data.carrier.id` (string, required)
    Zocdoc id for insurance carrier

  - `data.plan_type` (string, 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", "other", "uncategorized"

  - `data.program_type` (string, 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.status` (string, required)
    Status of the insurance plan
    Enum: "inactive", "active", "deleted"

  - `data.care_categories` (array, required)
    Enum: "health", "dental", "vision"

  - `data.coverage_area` (object, required)

  - `data.coverage_area.is_national` (boolean, required)

  - `data.coverage_area.states` (array)
    The two letter state codes where the insurance plan has coverage. Will be null when is_national true.

  - `data.ref_metadata` (object, required)

  - `data.ref_metadata.created_timestamp_utc` (string)
    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_utc` (string)
    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 400 fields (application/json):

  - `request_id` (string, required)

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)