---
title: "An asynchronous request to claim a wallet to self custody"
method: POST
path: "/user/wallet/claim"
tags: ["Wallet management endpoints"]
---

# An asynchronous request to claim a wallet to self custody

`POST /user/wallet/claim`

An asynchronous request to claim a wallet to self custody, using a server generated secret.

## Headers

- `x-api-key` string, required

## Request body

- WalletInviteRequest
  - `emailAddress` string — Email address to register
  - `password` string — Password to use when creating new wallet

## Response `200`

Successfully requested to claim the wallet to self custody. The status will of the response will always be PROCESSING. Must use the corresponding GET endpoint to check status to determine when claiming is complete.

- WalletOnboardResponse
  - `secret` string — A secret created by the server and provided to the client only at initial wallet creation
  - `state` string — Indicates custody state of the wallet (CUSTODY or SELF_CUSTODY)
  - `status` string — Indicates status of the onboarding process
  - `addresses` object — Blockchain addresses associated with the wallet
    - `SYMBOL` string — Blockchain address associated with symbol

## Other responses

- `403` — Not authorized
- `409` — Wallet already claimed or email already in use
- `429` — Too many attempts

---

[API](https://skmtc.net/unstoppabledomains/apis/profile-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/profile-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/profile-api/revisions/10f8400cb1c1/schema)