# Get a Wallet's Setup

One MPC wallet's setup: its state, its next step, whether it can receive and spend, and when each step happened.

## Overview

- `state`: `pending`, `aux_running`, `ready_for_backup`, `backup_confirmed`, `active` or `retired`; `nextStep`: what your app does next ([MPC Wallet Setup › Setup States](https://docs.aureahub.com/docs/guide-wallet-setup.md)).
- `canReceive`: the wallet may be bound for receiving — registered, not retired, its backup confirmed and from the backup on — its second ceremony need not be done. `canSpend`: it may sign — it can receive and its second ceremony is done.
- `backupConfirmedAt` and `backupConfirmedBy` (`proof` or `client_report`): when and how the backup was confirmed — its proof, else your app's report.
- `steps`: when each step happened, `null` before it. `sharesKeptUntil`: for a retired wallet, the earliest time its shares may be removed.
- The wallet's own user only: `403` `MPC_WALLET_NOT_OWNED` for another user's, `404` `MPC_WALLET_NOT_FOUND` for none.

## Endpoint

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

Authentication: bearer token required.

Returns the MPC wallet's setup.

**Path parameters**

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

**Responses**

`200` Can receive

```json
{
  "walletId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
  "address": "0xAbCd…",
  "chain": "base",
  "isTestnet": true,
  "curve": "secp256k1",
  "scheme": "cggmp",
  "state": "backup_confirmed",
  "nextStep": "activate",
  "backupConfirmedAt": "2026-11-05T09:30:12.000Z",
  "backupConfirmedBy": "client_report",
  "canReceive": true,
  "canSpend": true,
  "steps": {
    "dkgStartedAt": "2026-11-05T09:29:40.000Z",
    "registeredAt": "2026-11-05T09:29:55.000Z",
    "auxStartedAt": "2026-11-05T09:29:57.000Z",
    "auxCompletedAt": "2026-11-05T09:30:05.000Z",
    "backupProvenAt": null,
    "backupReportedAt": "2026-11-05T09:30:12.000Z",
    "activatedAt": null,
    "retiredAt": null
  },
  "retiredReason": null,
  "sharesKeptUntil": null
}
```

`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/setup \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

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