# List backup schedule history

`GET /backup-schedules/{schedule_id}/history`

:::code-group
```shellscript title="curl"
curl -sS "https://api.pinecone.io/backup-schedules/${SCHEDULE_ID}/history" \
  -H "api-key: ${PINECONE_API_KEY}" \
  -H "X-Pinecone-Api-Version: 2026-04"
```
:::

:::code-group
```json title="curl"
{
  "data": [
    {
      "backup_id": "16098c2f-f9ff-4db3-b8b2-4b02d119cd53",
      "source_index_id": "d40265e4-a492-402b-9cf1-973b4908b7a0",
      "source_index_name": "my-index",
      "tags": {},
      "name": "my-nightly-backup-20260424T060000Z",
      "description": null,
      "status": "Scheduled",
      "scheduled_execution_at": "2026-04-24T06:00:00.244035Z",
      "cloud": "aws",
      "region": "us-east-1",
      "dimension": 2,
      "schema": null,
      "record_count": null,
      "namespace_count": null,
      "size_bytes": null,
      "created_at": "2026-04-23T16:36:51.511526Z"
    }
  ],
  "pagination": null
}
```
:::

:::callout{intent="note"}
This endpoint requires `X-Pinecone-Api-Version: 2026-04`.
:::

List backups created by a specific schedule. When a backup’s `status` is `Scheduled`, the `scheduled_execution_at` field indicates the planned run time. Supports pagination.

### Path parameters

- `schedule_id` (string, required) — The ID of the backup schedule.

### Query parameters

- `limit` (integer) — The maximum number of results to return.

- `paginationToken` (string) — A token for fetching the next page of results.

```shellscript
curl -sS "https://api.pinecone.io/backup-schedules/${SCHEDULE_ID}/history" \
  -H "api-key: ${PINECONE_API_KEY}" \
  -H "X-Pinecone-Api-Version: 2026-04"
```

```json
{
  "data": [
    {
      "backup_id": "16098c2f-f9ff-4db3-b8b2-4b02d119cd53",
      "source_index_id": "d40265e4-a492-402b-9cf1-973b4908b7a0",
      "source_index_name": "my-index",
      "tags": {},
      "name": "my-nightly-backup-20260424T060000Z",
      "description": null,
      "status": "Scheduled",
      "scheduled_execution_at": "2026-04-24T06:00:00.244035Z",
      "cloud": "aws",
      "region": "us-east-1",
      "dimension": 2,
      "schema": null,
      "record_count": null,
      "namespace_count": null,
      "size_bytes": null,
      "created_at": "2026-04-23T16:36:51.511526Z"
    }
  ],
  "pagination": null
}
```

Was this page helpful?

## Related pages

- [Create backup schedule](./database-2026-07-control-plane-create-backup-schedule.md)
- [List backup schedules](./database-2026-07-control-plane-list-backup-schedules.md)
- [Describe backup schedule](./database-2026-07-control-plane-describe-backup-schedule.md)
- [Update backup schedule](./database-2026-07-control-plane-update-backup-schedule.md)
- [Delete backup schedule](./database-2026-07-control-plane-delete-backup-schedule.md)
- [List backup schedule history](./database-2026-07-control-plane-list-backup-schedule-history.md)
- [Create backup schedule](./database-2026-04-control-plane-create-backup-schedule.md)
- [List backup schedules](./database-2026-04-control-plane-list-backup-schedules.md)
- [Describe backup schedule](./database-2026-04-control-plane-describe-backup-schedule.md)
- [Update backup schedule](./database-2026-04-control-plane-update-backup-schedule.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.