# List backups for an index

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

```bash curl theme={null}
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-04" \
    -H "accept: application/json"
```

```json curl theme={null}
{
  "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
}
```

`GET /indexes/{index_name}/backups`

:::code-group
```bash title="cURL"
curl --request GET \
  --url https://api.pinecone.io/indexes/{index_name}/backups \
  --header 'Authorization: Bearer <token>'
```

```json title="200"
{
  "data": [
    {
      "backup_id": "670e8400-e29b-41d4-a716-446655440001",
      "source_index_name": "my-index",
      "source_index_id": "670e8400-e29b-41d4-a716-446655440000",
      "source_index_deleted_at": "2024-03-05T12:00:00.000Z",
      "name": "backup-2025-02-04",
      "description": "Backup before bulk update.",
      "status": "Ready",
      "cloud": "aws",
      "region": "us-east-1",
      "dimension": 1536,
      "metric": "<string>",
      "schema": {
        "fields": {
          "description": {
            "filterable": true
          },
          "genre": {
            "filterable": true
          },
          "year": {
            "filterable": true
          }
        }
      },
      "record_count": 120000,
      "namespace_count": 3,
      "size_bytes": 10000000,
      "tags": {
        "tag0": "val0",
        "tag1": "val1"
      },
      "created_at": "<string>"
    }
  ],
  "pagination": {
    "next": "dXNlcl9pZD11c2VyXzE="
  }
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Path Parameters

- `index_name` (path, string, required) — Name of the index whose backups are listed. When `include_deleted` is false or omitted, this must resolve to an active index in the project.

## Query Parameters

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

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Response

- `200` — Returns backups associated with the index name. With `include_deleted` true, backups for all versions of the index name are returned. With `include_deleted` false, only backups for the active index are returned, or **404** if there is no active index.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `404` — Index not found.
- `500` — Internal server error.

## Related pages

- [Create a backup of an index](./database-2026-07-control-plane-create-backup.md)
- [List backups for all indexes in a project](./database-2026-07-control-plane-list-project-backups.md)
- [List backups for an index](./database-2026-07-control-plane-list-index-backups.md)
- [Describe a backup](./database-2026-07-control-plane-describe-backup.md)
- [Delete a backup](./database-2026-07-control-plane-delete-backup.md)
- [Create an index from a backup](./database-2026-07-control-plane-create-index-from-backup.md)
- [List restore jobs](./database-2026-07-control-plane-list-restore-jobs.md)
- [Describe a restore job](./database-2026-07-control-plane-describe-restore-job.md)
- [List collections](./database-2026-07-control-plane-list-collections.md)
- [Create a collection](./database-2026-07-control-plane-create-collection.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.