Business Address Verification
This endpoint request business address verification
POST
{{baseurl}}/candidates/:candidateId/merchantsHeader
Parameter
{
"description": "Hello",
"merchant": {
"name": "CAC Consult",
"email": "famous@youverify.co",
"mobile": "08000000000",
"registration_number": "123456789"
},
"address": {
"flat_number": "5",
"building_name": "White Building",
"building_number": "3",
"street": "13B Bishop Street",
"landmark": "Opposit Ilupeju Police station",
"sub_street": "Bishop",
"state": "Lagos",
"city": "Ilupeju",
"postcode": "234001",
"country": "Nigeria"
}
}HTTP/1.1 200 OK
{
"message": "Successful",
"data": {
"id": "reports_e3c2e12f-3efb-4a8a-a538-c29fbf338762",
"reference_id": "61f9d6f29c64d",
"subject_consent": true,
"candidate": {
"id": "e4f7320c-527b-471b-9670-725958a633e3",
"reference_id": "YV61f9097146dfe3308",
"name": "Ehichioya Prior Famous",
"first_name": "Famous",
"last_name": "Ehichioya",
"middle_name": "Prior",
"email": "famous@youverify.co",
"mobile": "08030000000",
"has_live_photo": true,
"live_photo_path": "https://youverify-api-bucket.nyc3.digitaloceanspaces.com/reports/live_photos/2022-02-01/photo_61f9ab425c5f67328.jpg"
},
"start_time": "2022-02-02",
"end_time": "2022-02-02",
"execution_date": "",
"submitted_at": "",
"completed_at": null,
"accepted_at": null,
"revalidation_date": "2022-05-02",
"status": "unassigned",
"task_status": "PENDING",
"reason": null,
"task_created_by": "Chinook Devops",
"package": "merchant_verification",
"download_url": null,
"description": "Verify subject",
"package_name": "Merchant Verification",
"details": {
"id": 117,
"uuid": "d1d9c6a0-59de-4ad4-a306-56b266f71053",
"address_id": 20305,
"candidate_id": 4734567,
"status": "PENDING",
"registration_number": "123456789",
"name": "CAC Consult",
"email": "famous@youverify.co",
"mobile": "08000000000",
"telephone": "",
"deleted_at": null,
"created_at": "2022-02-02 01:57:22",
"updated_at": "2022-02-02 01:57:22",
"address": {
"uuid": "a49493c4-67c1-405b-8195-85a88c009acc",
"user_id": 1,
"user_type": "user",
"candidate_id": 4734567,
"flat_number": null,
"building_name": "White Building",
"building_number": "3",
"sub_street": "Bishop",
"street": "13B Bishop Street",
"landmark": "Opposit Ilupeju Police station",
"state": "lagos",
"city": "Ilupeju",
"post_code": null,
"country": "Nigeria",
"longitude": null,
"latitude": null,
"what3words": "",
"what3words_map": "",
"agent_geo": null,
"start_date": null,
"end_date": null,
"status": "PENDING",
"reason_for_fail": null,
"item_id": "0",
"item_type": "merchant_verification",
"created_at": "2022-02-02 01:57:21",
"updated_at": "2022-02-02 01:57:21",
"formatted": "Flat Number , White Building, 3, Sub Street Bishop, 13b Bishop Street, Opposit Ilupeju Police Station, Ilupeju, Lagos, Nigeria, ",
"map_format": "3 13b Bishop Street, Ilupeju , Lagos, Nigeria",
"map_address_url": null,
"map_geolocation_url": null
}
},
"has_address": true,
"notes": [],
"signature": [],
"is_flagged": 0,
"awaiting_qa": false,
"reportable_id": "d1d9c6a0-59de-4ad4-a306-56b266f71053",
"created_at": "2022-02-02 01:57:22",
"last_updated_at": "2022-02-02 01:57:22",
"what3words": null,
"what3words_map_link": null,
"digital_address_code": null,
"digital_address_url": null,
"map_address_url": null,
"map_geolocation_url": null,
"report_geolocation_url": null,
"report_longitude": null,
"report_latitude": null,
"can_view_report": true,
"business": "Youverify",
"reasons_for_failure": [
"Address does not exist",
"Address not accessible",
"Candidate does not live there",
"Incorrect Address",
"Nobody to confirm candidate lives at the address"
],
"submission_distance_in_meters": 0,
"building_type": null,
"building_color": null,
"gate_present": null,
"gate_color": null,
"availability_confirmed_by": null,
"closest_landmark": null,
"additional_info": null,
"report_agent_access": null,
"incident_report": null,
"images": {
"data": []
}
},
"status_code": 200
}HTTP/1.1 402 Payment Required
{
"success": false,
"statusCode": 402,
"message": "Insufficient fund",
"name": "PaymentRequiredError",
"data": {}
}
HTTP/1.1 500 Internal Server Error
{
"success": false,
"statusCode": 500,
"message": "Service unavailable",
"name": "Error",
"data": {}
}
HTTP/1.1 403 Forbidden
{
"success": false,
"statusCode": 403,
"message": "Permission denied",
"name": "UnauthorizedError",
"data": {}
}Last updated