# Bulk Exports in the API

The Create Bulk Export endpoint ([API docs](https://docs.ideonapi.com/#bulk-exports-bulk-exports-post)) can be used to asynchronously generate dataset files, allowing users to cache data locally to optimize real-time quoting integrations. Through this endpoint, datasets for plan benefits, service areas, and zip-counties can accessed in JSONL format. This page includes general information on using Bulk Exports; the following sub-pages details information specific to each of the supported datasets.

* [Plans](/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/plans.md) - available plans and their associated benefits. This file replaces the Plans in Bulk endpoint as the recommended workflow to cache plan benefits to optimize real-time quoting integrations.
* [Service Areas](/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/service-areas.md) - the service areas associated with each plan detailing their geographical availability, as defined by ZIP and FIPS codes. This file supports visibility for users into zip-county level plan availability prior to quoting, if desired.
* [Zip-Counties](/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/zip-counties.md) - the full set of ZIP and FIPS codes as well as their core metadata supported in Ideon's API.
* [Plan-Network Mapping](/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api/plan-network-mapping.md) - available plans with their plan identifiers, carrier metadata, and the identifier for their mapped provider-network. Available for IdeonSelect users in the Individual Medical, Small Group Medical, and Medicare Advantage markets.

## General Information

* The `download_url`'s are presigned for authentication. If the URL expires, users can hit the Show Bulk Export endpoint for the `export_id` to generate a new presigned `download_url` for the same export file.
* Requests to the Create Bulk Export endpoint are subject to additional rate limits in Ideon's API. Users are limited to generating 15 bulk exports per day; this is significantly more than would be required for any data caching workflow. These limitations do not apply to the Show Bulk Export endpoint.
* The processing time to generate a bulk export file can vary significantly based on the amount of data being returned. Zip Counties exports will typically complete within 15 seconds. Plan and Service Area exports can take a similar amount of time for very small exports, up to 15 minutes for larger ones. For the latter two export types, we recommend polling every couple of minutes for a *complete* status.
* An empty plans or service areas dataset indicates that the user does not have permissioned access to any plans given the requested filter parameters.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ideonapi.gitbook.io/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.