---
title: "GET /v2/deposit-recovery/{walletAddress}"
method: GET
path: "/v2/deposit-recovery/{walletAddress}"
tags: ["Deposit recovery"]
---

# GET /v2/deposit-recovery/{walletAddress}

`GET /v2/deposit-recovery/{walletAddress}`

## Request

- Base URL: `https://api.peer.xyz`
- URL: `https://api.peer.xyz/v2/deposit-recovery/{walletAddress}`
- Auth: HTTP bearer

## Path parameters

- `walletAddress` string, required

## Response `200`

Owner-scoped recovery state

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `policyVersion` string, required
    - `walletAddress` string, required
    - `status` 'not_configured' | 'ineligible' | 'suppressed' | 'inactive' | 'active' | 'pending' | 'needs_attention', required
    - `reason` string, nullable, required
    - `protectedChains` string[], required
    - `operation` object, nullable, required
      - `operationId` string, uuid, required
      - `revision` integer, required
      - `request` object, required
        - `version` 1, required
        - `url` string, uri, required
        - `method` 'POST', required
        - `headers` object, required
        - `body` object, required
          - `automation_ids` string[], required
          - `params` object
            - `destination_address` string, required
  - `statusCode` number, required
  - `errorCode` string

## Changes

- **2026-10-07** `c9d293adeaa8`: 1 breaking
  - removed the required property `responseObject/sourceChains` from the response with the `200` status
- **2026-10-06** `c2d8900694bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peer/apis/swagger-api/changes/v2/deposit-recovery/:walletAddress/get.md)

---

[API](https://skmtc.dev/peer/apis/swagger-api.md) - [All operations](https://skmtc.dev/peer/apis/swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peer/apis/swagger-api/revisions/ef91955315e2?raw)