By default, `list_imports` returns up to 100 imports per page. If the `limit` parameter is set, `list` returns up to that number of imports instead. Whenever there are additional IDs to return, the response includes `pagination.next`, a token you pass as `paginationToken` to get the next batch of imports. When the response has no `pagination`, there are no more imports to return.

For guidance and examples, see [Import data](/guides/index-data-import-data).

:::callout{intent="note"}
This feature is in [public preview](/guides/changelog-feature-availability) and available only on [Standard and Enterprise plans](https://www.pinecone.io/pricing/).
:::

```bash curl theme={null}
# To get the unique host for an index,
# see https://docs.pinecone.io/guides/manage-data/target-an-index
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="INDEX_HOST"

curl -X GET "https://$INDEX_HOST/bulk/imports?paginationToken=Tm90aGluZyB0byBzZWUgaGVyZQo" \
  -H 'Api-Key: $PINECONE_API_KEY' \
  -H 'X-Pinecone-Api-Version: 2026-07'
```

`GET /bulk/imports`

:::code-group
```bash title="cURL"
curl --request GET \
  --url https://{index_host}/bulk/imports \
  --header 'Authorization: Bearer <token>'
```

```json title="200"
{
  "data": [
    {
      "id": "101",
      "uri": "<string>",
      "status": "Pending",
      "createdAt": "<string>",
      "finishedAt": "<string>",
      "percentComplete": 42.2,
      "recordsImported": 1000000,
      "error": "<string>",
      "validationResult": {
        "importSuccesses": 999990,
        "importErrors": 10
      }
    }
  ],
  "pagination": {
    "next": "Tm90aGluZyB0byBzZWUgaGVyZQo="
  }
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Query Parameters

- `limit` (query, integer) — Max number of operations to return per page.
- `paginationToken` (query, string) — Pagination token to continue a previous listing operation.

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Response

- `200` — A list of import operations
- `400` — Bad request. The request body included invalid request parameters.
- `401` — Unauthorized. Possible causes: missing or invalid API key.
- `4XX` — An unexpected error response.
- `5XX` — An unexpected error response.

## Related pages

- [Start import](./database-2026-07-data-plane-start-import.md)
- [Describe an import](./database-2026-07-data-plane-describe-import.md)
- [Cancel an import](./database-2026-07-data-plane-cancel-import.md)
- [Start import](./database-2026-04-data-plane-start-import.md)
- [List imports](./database-2026-04-data-plane-list-imports.md)
- [Describe an import](./database-2026-04-data-plane-describe-import.md)
- [Cancel an import](./database-2026-04-data-plane-cancel-import.md)
- [Start import](./database-2025-10-data-plane-start-import.md)
- [List imports](./database-2025-10-data-plane-list-imports.md)
- [Describe an import](./database-2025-10-data-plane-describe-import.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.