> For the complete documentation index, see [llms.txt](https://docs.numaly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.numaly.com/send-verification.md).

# Create Verification Request

## Create Verification Request

<mark style="color:green;">`POST`</mark> `https://api.numaly.com/v1/requests`

#### Request Body

| Name                | Type    | Required | Description                                                                                                                                 |
| ------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| first\_name         | string  | true     | Applicants first name                                                                                                                       |
| last\_name          | string  | true     | Applicants last name                                                                                                                        |
| email               | string  | true     | Applicants email address                                                                                                                    |
| phone\_number       | String  | false    | <p>Applicants phone number to send the verification request to. <br>Although optional phone numbers almost guarantee a faster response.</p> |
| reference           | string  | true     | Reference for your record keeping (e.g property address etc)                                                                                |
| applicant\_pays     | boolean | true     | Do you want the applicant to pay the screening charge. if `false` your screening credits will be used.                                      |
| property\_rent      | integer | true     | Rent amount of the property applicant is applying for. Used to calculate the income to rent multiple.                                       |
| verify\_income      | boolean | true     | Do you want to verify applicants income via the bank                                                                                        |
| verify\_identity    | boolean | true     | Do you want the appllicants identity to be verified as part of the income verification                                                      |
| verify\_employment  | boolean | true     | Do you want to verify applicants employment via payroll account                                                                             |
| send\_to\_applicant | boolean | true     | True if you want the verification to be sent to the applicant. If ommited this defaults to True                                             |

{% tabs %}
{% tab title="201 Request successfully sent.
Note: This response does not guarantee the request reached the applicants mailbox. Make sure the applicants information is accurate prior." %}

```
{ 
    "id": "4ab1e5530-fb76-4621-b11a-c4480708fb2f",
    "verification_url": "https://example.numaly.com/request/1af90f9f-8640-4a53-8dbc-5a8f593a32a0"
    "expiry_date": "2021-03-10"
}
```

{% endtab %}

{% tab title="400 Invalid phone number (440)" %}

```
```

{% endtab %}

{% tab title="402 Insufficient screening credits." %}

```
```

{% endtab %}
{% endtabs %}