Send Verification Request

Instead of directing users to your verification link, you may send a verification request to their email or mobile phone.

Send Verification Request

POST https://api.numaly.com/v1/requests

Request Body

Name	Type	Description
first_name	string	Applicants first name
last_name	string	Applicants last name
email	string	Applicants email address
purpose	string	Purpose of the verification. Options areRental Application&Loan Application
reference	string	Reference for your record keeping (e.g property address etc)
applicant_pays	boolean	Do you want the applicant to pay the screening charge. if false your screening credits will be used.
rent	boolean	Rent amount of the property applicant is applying for. Used to calculate the income to rent multiple.
phone_number	number	Applicants phone number to send the verification request to. Although optional phone numbers almost guarantee a faster response.
verify_identity	boolean	Do you want the appllicants identity to be veirifed as part of the income verification

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",
    "expiry_date": "2021-03-10"
}

400 Invalid phone number (440)

402 Insufficient screening credits.