GET
/
bulk
/
imports
# To get the unique host for an index,
# see https://docs.pinecone.io/guides/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: $YOUR_API_KEY' \
  -H 'X-Pinecone-API-Version: 2025-04'

{
  "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="
  }
}

This feature is in public preview and available only on Standard and Enterprise plans.

# To get the unique host for an index,
# see https://docs.pinecone.io/guides/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: $YOUR_API_KEY' \
  -H 'X-Pinecone-API-Version: 2025-04'

{
  "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="
  }
}

Authorizations

​
Api-Key
string
header
required

An API Key is required to call Pinecone APIs. Get yours from the console.

Query Parameters

​
limit
integer
default:
100

Max number of operations to return per page.

Required range: 1 < x < 100
​
paginationToken
string

Pagination token to continue a previous listing operation.

Response

200
application/json
A list of import operations

The response for the list_imports operation.

​
data
object[]
​
pagination
object

Was this page helpful?

Start importDescribe an import