# Update Insurance Offerings

Currently the Insurance API is for select partners. If you are unsure if you have access, please contact Zocdoc.

Before using this guide you will need a developer account and an access token. You can contact us about creating a developer account [here](https://developer.zocdoc.com/?utm_medium=organicpro&utm_routing=API_Sender#api-form). To get an access token, review the [authentication and access tokens](/guides/authentication) guide.

## 1. Look Up Insurance Information

Before making changes, you’ll want to understand the current insurance ecosystem: plans available, categories, and what's already mapped for a provider location.

There are multiple levels of insurance information granularity you can retrieve via endpoints.

details
summary
strong
Retrieve a list of insurance plans
Use this endpoint to fetch a list of insurance plans based on filters like:

* Status: `active`, `inactive`, `deleted`
* Plan Type: `hmo`, `ppo`, `epo`, `pos`, etc.
* Program Type: `commercial`, `medicare`, `medicaid`, etc.
* Care Category: `health`, `dental`, `vision`
* State: e.g., `NY`, `CA`


details
summary
strong
Get details of a specific insurance plan
Returns detailed info about a specific insurance plan. Use this to populate plan descriptions or review coverage specifics.

details
summary
strong
See current insurance mappings for a provider location
Fetches the insurance plans currently mapped to a specific provider location, grouped by:

* Carrier
* Program
* Network


This endpoint only supports providers with insurance mappings at the provider_location level. Requests for providers with insurance mappings at other entity levels will return a 409 conflict error.

Note
For more information on each plan such as the name and other details you need to use the `insurance_plans` endpoint above.

## 2. Make Changes to Insurance mappings

Submit a request to **add**, **remove**, or **replace** insurance mappings.

Note
This is an asynchronous operation. Processing time varies depending on the volume of changes. For most cases, it completes instantaneously.


```json
{
  "$ref": "#/components/schemas/UpdateInsuranceMappingsRequest",
  "components": {
    "schemas": {
      "InsuranceMappingUpdateOperation": {
        "type": "string",
        "enum": [
          "Add",
          "Remove",
          "Replace"
        ]
      },
      "UpdateInsuranceMappingsRequest": {
        "type": "object",
        "required": [
          "operation",
          "insurance_plan_ids"
        ],
        "properties": {
          "insurance_plan_ids": {
            "description": "List of insurance plan ids",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "operation": {
            "$ref": "#/components/schemas/InsuranceMappingUpdateOperation"
          }
        }
      }
    }
  }
}
```

## 3. Confirm Changes

Once your async update has had time to process, re-fetch the current mappings: