Skip to main content
GET
/
bulk
/
imports
/
{id}
# 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/101" \
  -H 'Api-Key: $PINECONE_API_KEY' \
  -H 'X-Pinecone-Api-Version: 2025-10'

{
  "id": "101",
  "uri": "s3://BUCKET_NAME/PATH/TO/DIR",
  "status": "Pending",
  "created_at": "2024-08-19T20:49:00.754Z",
  "finished_at": "2024-08-19T20:49:00.754Z",
  "percent_complete": 42.2,
  "records_imported": 1000000
}
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/manage-data/target-an-index
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="INDEX_HOST"

curl -X GET "https://$INDEX_HOST/bulk/imports/101" \
  -H 'Api-Key: $PINECONE_API_KEY' \
  -H 'X-Pinecone-Api-Version: 2025-10'

{
  "id": "101",
  "uri": "s3://BUCKET_NAME/PATH/TO/DIR",
  "status": "Pending",
  "created_at": "2024-08-19T20:49:00.754Z",
  "finished_at": "2024-08-19T20:49:00.754Z",
  "percent_complete": 42.2,
  "records_imported": 1000000
}

Authorizations

​
Api-Key
string
header
required

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

Headers

​
X-Pinecone-Api-Version
string
default:2025-10
required

Required date-based version header

Path Parameters

​
id
string
required

Unique identifier for the import operation.

Required string length: 1 - 1000

Response

Details of the import operation.

The model for an import operation.

​
id
string

Unique identifier for the import operation.

Required string length: 1 - 1000
Example:

"101"

​
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.

Example:

"Pending"

​
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.

Required range: 0 <= x <= 100
Example:

42.2

​
recordsImported
integer<int64>

The number of records successfully imported.

Example:

1000000

​
error
string

The error message if the import process failed.