# Send a Phone Code

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

Send a one-time code to the user's phone number, to verify it.

## Overview

- `phoneNumber` in international format. The user then enters the code they received in [Check the Phone Code](https://docs.aureahub.com/docs/cards-phone-check.md).
- Inside the card program session; the answer is the card program's.
- **Illustrative example.** The card program's answer is passed through unchanged and may carry fields not listed here: the example shows only the fields Aurea or its own app reads. Ignore the fields you do not know.

## Endpoint

### `POST /v1/gnosis/verification`

Authentication: bearer token required.

Sends a verification code to the user's phone.

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `phoneNumber` | string | no | The number to verify, e.g. `+393401234567` |
| `documentType` | string | no | Passed on to the card program when sent |

**Responses**

`200` OK (illustrative)

```json
{ … }
```

**Example request**

```bash
curl -X POST https://api.aureahub.com/v1/gnosis/verification \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "+393401234567"}'
```

---

Web version: https://docs.aureahub.com/#cards-phone-start