# Request a wallet

<mark style="color:green;">`POST`</mark> `/auth/request-wallet`

This endpoint is designed to initiate the process of creating or retrieving a user's wallet. It requires the user to authenticate and then submit a request with either an email or a phone number. The system will then either create a new wallet if one does not exist for the submitted credentials or return an existing wallet if it is already associated with them.

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <API_KEY>` |

**Body**

<table><thead><tr><th width="210">Name</th><th>Type</th><th width="278">Description</th><th>Required</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>email of wallet holder </td><td>OPTIONAL</td></tr><tr><td>phone</td><td>string</td><td>phone of wallet holder </td><td>OPTIONAL</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "status": 200,
  "wallet": <wallet_address>
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "code": 400,
  "message": <error message>
}
```

{% endtab %}
{% endtabs %}