Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

List backup schedule history

List execution history for a Pinecone backup schedule, including scheduled runs, completed backups, statuses, and cursor-based pagination support.

GET /backup-schedules/{schedule_id}/history

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"
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
}

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.

  • schedule_id (string, required) — The ID of the backup schedule.
  • 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?

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu