Request guarantor address verification

This endpoint request guarantor address verification

POST

{{baseurl}}/v1/candidates/:candidateId/references

Permission: Request Address Verification

FieldTypeDescription

token

String

Secret API token

Parameter

FieldTypeDescription

subject_consent

Boolean

Candidate consent. Must be true

description optional

String

Description or any information for the agent

address

Object

Candidate address object

flat_number optional

String

Address flat number

building_name optional

String

Address building name

building_number

String

Address building number

landmark

String

Address landmark

street

String

Address street

sub_street optional

String

Address sub street

state

String

Address state

city

String

Address city

postcode optional

String

Address postcode

reference

Object

Guarantor object

first_name

String

Guarantor first name

last_name

String

Guarantor last name

mobile

String

Guarantor mobile

email

String

Guarantor email address

image optional

String

Guarantor image. URI or Base64 image

{
    "description": "Verify subject",
    "subject_consent": true,
    "reference": {
        "first_name": "Famous",
        "last_name": "Ehichioya",
        "email": "famous@youverify.co",
        "mobile": "08000000000"
    },
    "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",
        "start_date": "2017-10-05",
        "end_date": "2017-10-09"
    }
}
HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "reports_dab2b2c0-61c7-4b8c-9f48-236f6066e699",
            "reference_id": "61f9da1582fc0",
            "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": "reference_check",
            "download_url": null,
            "description": "Verify candidate",
            "package_name": "Reference Check Address Verification",
            "details": {
                "uuid": "c1a47576-1f66-406a-b182-8c815698a5a6",
                "address_id": 20308,
                "first_name": "Famous",
                "last_name": "Ehichioya",
                "email": "famous@youverify.co",
                "mobile": "",
                "photo_url": null,
                "status": "PENDING",
                "reason_for_fail": null,
                "created_at": "2022-02-02 02:10:44",
                "updated_at": "2022-02-02 02:10:44",
                "name": "Ehichioya Famous",
                "address": {
                    "uuid": "ed6c4a94-7bff-4a22-bd71-e05fee0ceb54",
                    "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": "reference",
                    "created_at": "2022-02-02 02:10:44",
                    "updated_at": "2022-02-02 02:10:44",
                    "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
                },
                "guarantor_image": null
            },
            "has_address": true,
            "notes": [],
            "signature": [],
            "is_flagged": 0,
            "awaiting_qa": false,
            "reportable_id": "c1a47576-1f66-406a-b182-8c815698a5a6",
            "created_at": "2022-02-02 02:10:45",
            "last_updated_at": "2022-02-02 02:10:45",
            "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
    }

Last updated