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 also includes a `pagination_token` that you can use to get the next batch of imports. When the response does not include a `pagination_token`, 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-04'
```

```json curl theme={null}
{
  "data": [
    {
      "id": "1",
      "uri": "s3://BUCKET_NAME/PATH/TO/DIR",
      "status": "Pending",
      "started_at": "2024-08-19T20:49:00.754Z",
      "finished_at": "2024-08-19T20:49:00.754Z",
      "percent_complete": 42.2,
      "records_imported": 1000000
    }
  ],
  "pagination": {
    "next": "Tm90aGluZyB0byBzZWUgaGVyZQo="
  }
}
```

`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>"
    }
  ],
  "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.
- `4XX` — An unexpected error response.
- `5XX` — An unexpected error response.

## Related pages

- [Start import](./database-2026-07-data-plane-start-import.md)
- [List imports](./database-2026-07-data-plane-list-imports.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)
- [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.