List backups for an index
When include_deleted is false (or omitted), index_name must resolve to an active index in the project. If no active index by that name exists—including the case where only deleted indexes have used the name—the API returns 404, not an empty list.
When include_deleted is true, the API returns backups from every index in the project that has ever used this name (active and deleted). The source_index_deleted_at field is present only when the backup is from a deleted index. 404 is returned only when no index by that name has ever existed in the project (active or deleted).
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_NAME="docs-example"
curl -X GET "https://api.pinecone.io/indexes/$INDEX_NAME/backups" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07" \
-H "accept: application/json"GET /indexes/{index_name}/backups
Parameters
Section titled “Parameters”X-Pinecone-Api-Version(header, string, required) — Required date-based version headerindex_name(path, string, required) — Name of the index whose backups are listed. Wheninclude_deletedis false or omitted, this must resolve to an active index in the project.include_deleted(query, boolean) — When true, includes backups for every index incarnation with this name (active and deleted). When false or omitted, only the active index's backups are included; 404 when no active index has that name.limit(query, integer) — The number of results to return per page.paginationToken(query, string) — The token to use to retrieve the next page of results. A malformed token is rejected with400.
Responses
Section titled “Responses”200— Returns backups associated with the index name. Withinclude_deletedtrue, backups for all versions of the index name are returned. Withinclude_deletedfalse, only backups for the active index are returned, or 404 if there is no active index.400— Bad request. The request body included invalid request parameters.401— Unauthorized. Possible causes: missing or invalid API key.403— Forbidden. The API key or principal is authenticated but lacks the permission required for this operation. Grant the required permission to the key's role, or use a key that already holds it.404— Index not found.500— Internal server error.