# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.numaly.com/send-verification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.