# List backup schedule history

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

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.

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

## Related pages

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