Describe an import
Return details of a specific import operation.
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/101" \
-H 'Api-Key: $PINECONE_API_KEY' \
-H 'X-Pinecone-Api-Version: 2026-07'GET /bulk/imports/{id}
{
"id": "101",
"uri": "<string>",
"status": "Pending",
"createdAt": "<string>",
"finishedAt": "<string>",
"percentComplete": 42.2,
"recordsImported": 1000000,
"error": "<string>",
"validationResult": {
"importSuccesses": 999990,
"importErrors": 10
}
}{
"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
Path Parameters
Section titled “Path Parameters”idstringrequiredUnique identifier for the import operation.
Required string length: 1 - 1000
Response
Section titled “Response”200 — Details of the import operation.
The model for an import operation.
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