List backups for an index

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: 2025-10" \
    -H "accept: application/json"

{
  "data":
  [
    {
      "backup_id":"9947520e-d5a1-4418-a78d-9f464c9969da",
      "source_index_id":"8433941a-dae7-43b5-ac2c-d3dab4a56b2b",
      "source_index_name":"docs-example",
      "tags":{},
      "name":"example-backup",
      "description":"Monthly backup of production index",
      "status":"Pending",
      "cloud":"aws",
      "region":"us-east-1",
      "dimension":1024,
      "record_count":98,
      "namespace_count":3,
      "size_bytes":1069169,
      "created_at":"2025-03-11T18:29:50.549505Z"
      }
    ],
  "pagination":null
}

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

index_name

string

required

Name of the backed up index

Query Parameters

limit

integer

default:10

The number of results to return per page.

Required range: 1 <= x <= 100

paginationToken

string

The token to use to retrieve the next page of results.

Response

This operation returns a list of all the backups that you have previously created, and which are associated with the given index.

The list of backups that exist in the project.

data

object[]

List of backup objects

Show child attributes

data.backup_id

string

required

Unique identifier for the backup.

Example:

"670e8400-e29b-41d4-a716-446655440001"

data.source_index_name

string

required

Name of the index from which the backup was taken.

Example:

"my-index"

data.source_index_id

string

required

ID of the index.

Example:

"670e8400-e29b-41d4-a716-446655440000"

data.status

string

required

Current status of the backup (e.g., Initializing, Ready, Failed).

Example:

"Ready"

data.cloud

string

required

Cloud provider where the backup is stored.

Example:

"aws"

data.region

string

required

Cloud region where the backup is stored.

Example:

"us-east-1"

data.name

string

Optional user-defined name for the backup.

Example:

"backup-2025-02-04"

data.description

string

Optional description providing context for the backup.

Example:

"Backup before bulk update."

data.dimension

integer<int32>

The dimensions of the vectors to be inserted in the index.

Required range: 1 <= x <= 20000

Example:

1536

data.metric

string

The distance metric to be used for similarity search. You can use 'euclidean', 'cosine', or 'dotproduct'. If the 'vector_type' is 'sparse', the metric must be 'dotproduct'. If the vector_type is dense, the metric defaults to 'cosine'. Possible values: cosine, euclidean, or dotproduct.

data.schema

object

Schema for the behavior of Pinecone's internal metadata index. By default, all metadata is indexed; when schema is present, only fields which are present in the fields object with a filterable: true are indexed. Note that filterable: false is not currently supported.

Show child attributes

data.schema.fields

object

required

A map of metadata field names to their configuration. The field name must be a valid metadata field name. The field name must be unique.

Show child attributes

data.schema.fields.{key}

object

Show child attributes

data.schema.fields.{key}.filterable

boolean

Whether the field is filterable. If true, the field is indexed and can be used in filters. Only true values are allowed.

Example:

{
  "fields": {
    "description": { "filterable": true },
    "genre": { "filterable": true },
    "year": { "filterable": true }
  }
}

data.record_count

integer

Total number of records in the backup.

Example:

120000

data.namespace_count

integer

Number of namespaces in the backup.

Example:

3

data.size_bytes

integer

Size of the backup in bytes.

Example:

10000000

data.tags

object

Custom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '', or '-'. Values must be alphanumeric, ';', '@', '', '-', '.', '+', or ' '. To unset a key, set the value to be an empty string.

Show child attributes

data.tags.{key}

string

Example:

{ "tag0": "val0", "tag1": "val1" }

data.created_at

string

Timestamp when the backup was created.

pagination

object

The pagination object that is returned with paginated responses.

Show child attributes

pagination.next

string

required

The token to use to retrieve the next page of results.

Example:

"dXNlcl9pZD11c2VyXzE="

Example:

{ "next": "dXNlcl9pZD11c2VyXzE=" }

APIs

Database

Inference

Admin

SDKs

CLI

Tools

List backups for an index

Authorizations

Headers

Path Parameters

Query Parameters

Response