# Get the Backup State

Whether an MPC wallet's backup share was proven held, when, and whether to ask the user to prove it again.

## Overview

- `backupPresent`: a backup proof of the wallet completed. `backupConfirmedAt`: when the last one did, `null` when never.
- `backupReconfirmDue`: `true` when the backup was never proven, or last proven `reconfirmDays` days ago or more. Then ask the user to prove it again ([Start a Backup Proof](https://docs.aureahub.com/docs/mpc-backup-proof-start.md)) — a reminder, never a block: nothing is refused because of it.
- Read it when the wallet is opened. The wallet's owner only: `404` `MPC_WALLET_NOT_FOUND`, `403` `MPC_WALLET_NOT_OWNED` as at Start.
- [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md) Where your tenant has them, [Register MPC Wallet](https://docs.aureahub.com/docs/mpc-wallet-register.md) also answers `backupConfirmedAt` and `backupReconfirmDue`; this route answers them always.

## Endpoint

### `GET /v1/mpc/wallets/{walletId}/backup`

Authentication: bearer token required.

Returns the MPC wallet's backup state.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `walletId` | string (uuid) | yes | The MPC wallet's id |

**Responses**

`200` Never proven

```json
{
  "walletId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
  "backupPresent": false,
  "backupConfirmedAt": null,
  "backupReconfirmDue": true,
  "reconfirmDays": 90
}
```

`404` Not Found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "mpc wallet not found",
  "details": { "code": "MPC_WALLET_NOT_FOUND" }
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/mpc/wallets/7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b/backup \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#mpc-backup-get