# List Preparations

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The caller's device preparations: the open ones and the ten newest ended ones, newest first.

## Overview

- The device reconciles its own records with this list ([Prepare the Device in Advance](https://docs.aureahub.com/docs/guide-device-preparation.md) › Resume and Clean Up): a record whose preparation ended is deleted on the device; an open preparation the device no longer holds is deleted here ([Delete a Preparation](https://docs.aureahub.com/docs/mpc-preparations-delete.md)). `deviceKeyFp` — SHA-256 of the device key's SubjectPublicKeyInfo, base64url — tells the device which are its own.
- `state`: `running` → `ready` (both sides agree) → `consumed` (one wallet made with it, `walletId`); `failed`, `expired`, `revoked`: ended unused. `failureReason`: `session_expired` (the ceremony stopped), `cosigner_refused`, `digest_mismatch`, `aurea_result_invalid`, `device_result_invalid`.
- No digest and no key material is ever returned.

### `GET /v1/mpc/preparations`

Authentication: bearer token required.

The caller's open preparations and the ten newest ended ones.

**Responses**

`200` OK

```json
{
  "data": [
    {
      "preparationId": "9a4c1e27-5b3d-4f8a-b6e2-0d7c3a91f5e4",
      "sessionId": "prep-2f6b8d14-7c3e-4a95-8e1d-5b0a9c4f7e32",
      "state": "ready",
      "createdAt": "2026-11-11T09:10:02.118Z",
      "readyAt": "2026-11-11T09:12:40.502Z",
      "expiresAt": "2026-12-11T09:10:02.118Z",
      "deviceKeyFp": "EXAMPLE_sha256_of_the_device_key_spki_b64url",
      "failureReason": null,
      "walletId": null
    }
  ]
}
```

---

Web version: https://docs.aureahub.com/#mpc-preparations-list