List 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 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.
# 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
{
"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="
}
}{
"code": 123,
"message": "<string>",
"details": [
{
"typeUrl": "<string>",
"value": "<string>"
}
]
}{
"code": 123,
"message": "<string>",
"details": [
{
"typeUrl": "<string>",
"value": "<string>"
}
]
}{
"code": 123,
"message": "<string>",
"details": [
{
"typeUrl": "<string>",
"value": "<string>"
}
]
}Authorizations
Section titled “Authorizations”Api-KeystringrequiredAn API Key is required to call Pinecone APIs. Get yours from the console.
Headers
Section titled “Headers”X-Pinecone-Api-VersionstringrequiredRequired date-based version header
Query Parameters
Section titled “Query Parameters”limit?integerMax number of operations to return per page.
Required range: 1 <= x <= 100
paginationToken?stringPagination token to continue a previous listing operation.
Response
Section titled “Response”200 — A list of import operations
The response for the list_imports operation.
data?object[]Show child attributes
idstringrequiredUnique identifier for the import operation.
Required string length: 1 - 1000. Example: 101
uristringrequiredThe URI from where the data is imported.
statusstringrequiredThe status of the operation. Possible values: Pending, InProgress, Failed, Completed, or Cancelled.
Example: Pending
createdAtstringrequiredThe start time of the import operation.
finishedAt?stringThe end time of the import operation.
percentCompletenumberrequiredThe progress made by the operation, as a percentage.
Required range: 0 <= x <= 100. Example: 42.2
recordsImportedintegerrequiredThe number of records successfully imported.
Required range: 0 <= x. Example: 1000000
error?stringThe error message if the import process failed.
validationResult?objectThe result of the validation run performed on the import data. Present only once validation has run.
Show child attributes
importSuccesses?integerThe number of records that passed validation.
Required range: 0 <= x. Example: 999990
importErrors?integerThe number of records that failed validation.
Required range: 0 <= x. Example: 10
pagination?objectShow child attributes
nextstringrequiredExample: Tm90aGluZyB0byBzZWUgaGVyZQo=