> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt > Use this file to discover all available pages before exploring further. # List restore jobs > List all restore jobs for a project. ```bash curl theme={null} PINECONE_API_KEY="YOUR_API_KEY" curl "https://api.pinecone.io/restore-jobs" \ -H "X-Pinecone-Api-Version: 2026-07" \ -H "Api-Key: $PINECONE_API_KEY" ``` ## OpenAPI ````yaml https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /restore-jobs openapi: 3.0.3 info: title: Pinecone Control Plane API description: >- Pinecone is a vector database that makes it easy to search and retrieve billions of high-dimensional vectors. contact: name: Pinecone Support url: https://support.pinecone.io email: support@pinecone.io license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: 2026-07 servers: - url: https://api.pinecone.io description: Production API endpoints security: - ApiKeyAuth: [] tags: - name: Manage Indexes description: Actions that manage indexes externalDocs: description: More Pinecone.io API docs url: https://docs.pinecone.io/introduction paths: /restore-jobs: get: tags: - Manage Indexes summary: List restore jobs description: List all restore jobs for a project. operationId: list_restore_jobs parameters: - in: header name: X-Pinecone-Api-Version description: Required date-based version header required: true schema: default: 2026-07 type: string style: simple - in: query name: limit description: The number of results to return per page. schema: default: 100 type: integer style: form - in: query name: paginationToken description: >- The token to use to retrieve the next page of results. A malformed token is rejected with `400`. schema: type: string style: form responses: '200': description: >- This operation returns a list of all the restore jobs that you have previously created. content: application/json: schema: $ref: '#/components/schemas/RestoreJobList' examples: paginated-restore-jobs: summary: A list containing restore jobs. value: data: - backup_id: 670e8400-e29b-41d4-a716-446655440000 completed_at: '2024-03-15T10:35:00.000Z' created_at: '2024-03-15T10:30:00.000Z' percent_complete: 100 restore_job_id: 670e8400-e29b-41d4-a716-446655440001 status: Completed target_index_id: idx_456 target_index_name: my-index pagination: next: dXNlcl9pZD11c2VyXzE= non-paginated-restore-jobs: summary: A list containing restore jobs. value: data: - backup_id: 670e8400-e29b-41d4-a716-446655440000 completed_at: '2024-03-15T10:35:00.000Z' created_at: '2024-03-15T10:30:00.000Z' percent_complete: 100 restore_job_id: 670e8400-e29b-41d4-a716-446655440001 status: Completed target_index_id: idx_456 target_index_name: my-index no-restore-jobs: summary: An empty list. value: data: [] '400': description: Bad request. The request body included invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: index-metric-validation-error: summary: Validation error value: error: code: INVALID_ARGUMENT message: >- Bad request. The request body included invalid request parameters. status: 400 '401': description: 'Unauthorized. Possible causes: missing or invalid API key.' content: text/plain: schema: $ref: '#/components/schemas/UnauthorizedMessage' '403': description: >- Forbidden. The API key or principal is authenticated but lacks the permission required for this operation. Grant the required permission to the key's role, or use a key that already holds it. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: permission-denied: summary: Missing permission value: error: code: PERMISSION_DENIED message: >- Access denied: Permission control::backups::list is required status: 403 '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internal-server-error: summary: Internal server error value: error: code: UNKNOWN message: Internal server error status: 500 components: schemas: RestoreJobList: description: The list of restore jobs that exist in the project. type: object properties: data: description: List of restore job objects type: array items: $ref: '#/components/schemas/RestoreJobModel' pagination: nullable: true description: >- Cursor envelope for the next page. `null` (or absent) on the final page of results. type: object allOf: - example: next: dXNlcl9pZD11c2VyXzE= description: The pagination object that is returned with paginated responses. x-component-name: PaginationResponse type: object properties: next: example: dXNlcl9pZD11c2VyXzE= description: The token to use to retrieve the next page of results. type: string required: - next required: - data ErrorResponse: example: error: code: INVALID_ARGUMENT message: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. status: 400 description: The response shape used for all error responses. type: object properties: status: example: 500 description: The HTTP status code of the error. type: integer error: example: code: INVALID_ARGUMENT message: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. description: Detailed information about the error that occurred. type: object properties: code: description: >- The error code. Possible values: `OK`, `UNKNOWN`, `INVALID_ARGUMENT`, `DEADLINE_EXCEEDED`, `NOT_FOUND`, `ALREADY_EXISTS`, `PERMISSION_DENIED`, `UNAUTHENTICATED`, `RESOURCE_EXHAUSTED`, `FAILED_PRECONDITION`, `ABORTED`, `OUT_OF_RANGE`, `INTERNAL`, `FORBIDDEN`, `PAYMENT_REQUIRED`, `SERVICE_UNAVAILABLE`, `PAYLOAD_TOO_LARGE`, or `UNPROCESSABLE_ENTITY`. x-enum: - OK - UNKNOWN - INVALID_ARGUMENT - DEADLINE_EXCEEDED - NOT_FOUND - ALREADY_EXISTS - PERMISSION_DENIED - UNAUTHENTICATED - RESOURCE_EXHAUSTED - FAILED_PRECONDITION - ABORTED - OUT_OF_RANGE - INTERNAL - FORBIDDEN - PAYMENT_REQUIRED - SERVICE_UNAVAILABLE - PAYLOAD_TOO_LARGE - UNPROCESSABLE_ENTITY type: string message: example: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. description: A human-readable description of the error type: string details: description: >- Additional information about the error. This field is not guaranteed to be present. type: object required: - code - message required: - status - error UnauthorizedMessage: example: Invalid API key description: >- The plain-text body of a `401` response. Authentication failures are rejected before the request reaches the API, so they carry a short message rather than an `ErrorResponse`. type: string RestoreJobModel: description: The RestoreJobModel describes the status of a restore job. type: object properties: restore_job_id: example: 670e8400-e29b-41d4-a716-446655440001 description: Unique identifier for the restore job type: string backup_id: example: 670e8400-e29b-41d4-a716-446655440000 description: Backup used for the restore type: string target_index_name: example: sample-index description: Name of the index into which data is being restored type: string target_index_id: example: 670e8400-e29b-41d4-a716-446655440002 description: ID of the index type: string status: example: Completed description: |- Status of the restore job. Possible values: `Pending`, `Completed`, `Failed`, or `Cancelled`. x-enum: - Pending - Completed - Failed - Cancelled type: string created_at: nullable: true example: '2025-02-04T13:00:00.000Z' description: Timestamp when the restore job started type: string format: date-time completed_at: nullable: true example: '2025-02-04T14:00:00.000Z' description: >- Timestamp when the restore job finished. `null` until the job has completed. type: string format: date-time percent_complete: example: 100 description: >- Progress of the restore job: `100` once the job is `Completed`, absent while it is pending or after it has failed. Intermediate progress is not reported. type: integer format: int32 minimum: 0 maximum: 100 required: - restore_job_id - backup_id - target_index_name - target_index_id - status - created_at securitySchemes: ApiKeyAuth: type: apiKey in: header name: Api-Key description: >- An API Key is required to call Pinecone APIs. Get yours from the [console](https://app.pinecone.io/). ````