---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/restoreVerificationPlans"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/restoreVerificationPlans"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/restoreVerificationPlans

`GET /v1/projects/{projectsId}/locations/{locationsId}/restoreVerificationPlans`

## Request

- Base URL: `https://backupdr.googleapis.com`
- URL: `https://backupdr.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/restoreVerificationPlans`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-backupdr`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-backupdr`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Lists RestoreVerificationPlans in a given project and location.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListRestoreVerificationPlansResponse: The response message for getting a list of `RestoreVerificationPlans`.
  - `nextPageToken` string: A token which may be sent as page_token in a subsequent `ListRestoreVerificationPlans` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.
  - `restoreVerificationPlans` RestoreVerificationPlan[]: The list of `RestoreVerificationPlans` in the project for the specified location. If the `{location}` value in the request is "-", the response contains a list of resources from all locations. In case any location is unreachable, the response will only return restore verification plans in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations.
    - `createTime` string, google-datetime: Output only. When the `RestoreVerificationPlan` was created.
    - `description` string: Optional. The description of the `RestoreVerificationPlan` resource. The description allows for additional details about `RestoreVerificationPlan` and its use cases to be provided. An example description is the following: "This is a restore verification plan that performs a daily verification and cleans up the resources immediately after." The description must be at most 2048 characters.
    - `failureCleanupRule` RestoreVerificationCleanupRule: Defines the specific cleanup action.
      - `cleanupDelay` string, google-duration: Optional. Duration after restore finishes when cleanup triggers. Delay must be non-negative and at most 30 days (2592000 seconds).
      - `skipCleanup` boolean: Optional. If set to true, the restored resource will not be cleaned up.
    - `labels` object: Optional. User-defined labels.
    - `name` string: Output only. Identifier. The resource name of the `RestoreVerificationPlan`. Format: `projects/{project}/locations/{location}/restoreVerificationPlans/{restoreVerificationPlan}`
    - `schedule` string: Required. Describes the schedule on which the restore verification will be executed. The schedule is specified as a [Crontab](https://en.wikipedia.org/wiki/Cron#Overview) string.
    - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'INACTIVE' | 'UPDATING' | 'ERROR': Output only. The `State` for the `RestoreVerificationPlan`.
    - `successCleanupRule` RestoreVerificationCleanupRule: Defines the specific cleanup action.
      - `cleanupDelay` string, google-duration: Optional. Duration after restore finishes when cleanup triggers. Delay must be non-negative and at most 30 days (2592000 seconds).
      - `skipCleanup` boolean: Optional. If set to true, the restored resource will not be cleaned up.
    - `timeZone` string: Optional. Specifies the time zone to be used in interpreting schedule. The value of this field must be a time zone name from the [tz database](https://en.wikipedia.org/wiki/Tz_database), like "America/New_York" or "UTC". Defaults to `UTC` if not specified.
    - `updateTime` string, google-datetime: Output only. When the `RestoreVerificationPlan` was last updated.
  - `unreachable` string[]: Locations that could not be reached.

## Changes

- **2026-11-05** `da857420b4f6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/backupdr/changes/v1/projects/:projectsId/locations/:locationsId/restoreVerificationPlans/get.md)

---

[API](https://skmtc.dev/google/apis/backupdr.md) - [All operations](https://skmtc.dev/google/apis/backupdr/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/backupdr/revisions/da857420b4f6?raw)