Business Address Verification
This endpoint request business address verification
POST
{{baseurl}}/candidates/:candidateId/merchants
Header
Field | Type | Description |
---|---|---|
token | String | Secret API token |
Parameter
Field | Type | Description |
---|---|---|
subject_consent | Boolean | Candidate consent. |
description | String | Description or any information for the agent |
address | Object | Candidate address object |
flat_number | String | Address flat number |
building_name | String | Address building name |
building_number | String | Address building number |
landmark | String | Address landmark |
street | String | Address street |
sub_street | String | Address sub street |
state | String | Address state |
city | String | Address city |
postcode | String | Address postcode |
merchant | Object | Business object |
name | String | Business name |
String | Business email | |
mobile | String | Business mobile |
registration_number | String | Business registration number |
{
"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