---
title: "List imports"
method: GET
path: "/bulk/imports"
tags: ["Bulk Operations"]
---

# List imports

`GET /bulk/imports`

List all recent and ongoing import operations.

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](https://docs.pinecone.io/guides/index-data/import-data).

## Query parameters

- `limit` integer
- `paginationToken` string

## Headers

- `X-Pinecone-Api-Version` string, required

## Response `200`

A list of import operations

- DbDataListImportsResponse — The response for the `list_imports` operation.
  - `data` DbDataImportModel[]
    - `id` string — Unique identifier for the import operation.
    - `uri` string — The URI from where the data is imported.
    - `status` string — The status of the operation. Possible values: `Pending`, `InProgress`, `Failed`, `Completed`, or `Cancelled`.
    - `createdAt` string, date-time — The start time of the import operation.
    - `finishedAt` string, date-time — The end time of the import operation.
    - `percentComplete` number, float — The progress made by the operation, as a percentage.
    - `recordsImported` integer — The number of records successfully imported.
    - `error` string — The error message if the import process failed.
  - `pagination` DbDataPagination
    - `next` string

## Other responses

- `400` — Bad request. The request body included invalid request parameters.
- `4XX` — An unexpected error response.
- `5XX` — An unexpected error response.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/versions/35876583485d/schema)