# Update Insurance Offerings

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.

## 3. Confirm Changes

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