Onsite Verification

onsite_document_verification

POST https://secctrl.tutelar.io/api/v1/kyc/vision/onsite_document_verification

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
email	String	Yes	Email Address
country	String	Yes	Country Code
language	String	Yes	Language
callback_url	String	No	Webhook Url to get response

Sample Post Parameters```postman_json

{
    "email": "[e-mail]",
    "country": "IN",
    "language": "EN",
    "callback_url": ""
}

200: In Progress

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "1a6f71f9-8cd8-4510-922f-83723dc637c3",
    "status": "in_progress",
    "result": {
        "verification_status": "pending",
        "verification_url": "https://app.shuftipro.com/verification/process/cUYmvxwtMAdjtqXNmll3ErdNa8V22h77FpBjbbyiYUcU6tlda2BcWIG2l1Q4fiqw"
    },
    "requested_at": "2023-01-12T08:53:04.074Z"
}

200: Completed

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "bc14433e-3221-4e49-a9af-54538ff88f5c",
    "result": {
        "document_status": "SUCCESS",
        "email": "[e-mail]",
        "country": "IN",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "DHANUSHRAJA D"
                },
                "dob": "1994-11-14",
                "expiry_date": "2037-07-05",
                "issue_date": "2017-07-06",
                "document_number": "TN2220170006055",
                "selected_type": [
                    "driving_license"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 65
            }
        },
        "verification_result": {
            "face": 1,
            "document": {
                "document": 1,
                "document_visibility": 1,
                "document_must_not_be_expired": 1,
                "document_proof": null,
                "selected_type": 1,
                "document_country": 1,
                "face_on_document_matched": 1,
                "name": 1,
                "document_number": 1,
                "dob": 1,
                "issue_date": 1,
                "expiry_date": 1
            }
        },
        "info": {
            "agent": {
                "is_desktop": true,
                "is_phone": false,
                "device_name": "Macintosh",
                "browser_name": "Chrome 120.0.0.0",
                "platform_name": "Mac OS 10.15.7"
            },
            "geolocation": {
                "host": "49.207.180.255.actcorp.in",
                "ip": "49.207.180.255",
                "rdns": "49.207.180.255",
                "asn": "24309",
                "isp": "Atria Convergence Technologies",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Tamil Nadu",
                "region_code": "TN",
                "city": "Chennai",
                "postal_code": "600018",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "13.031100273132",
                "longitude": "80.255500793457",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "face": "673,391,846,526",
                    "expiry_date": "1994-11-14",
                    "document_type": "2017 0006055",
                    "first_name": "de 40\nNamo\nIndia Driving Licence(Tamil Nadu)\nTN22 2017 0006055\nDate of Issue\n06-07-2017\nDate of Birth\n14-11-1994\nDHANUSHRAJA D\nFather's Name\nDEVADASAN\nValidity\n05-07-2037\nBlood Group\nUnknown",
                    "document_official_name": "Swiss driver's license",
                    "gender": "F",
                    "document_country": "India",
                    "document_country_code": "IN",
                    "full_name": "DHANUSHRAJA D",
                    "last_name": "D",
                    "father_name": "DEVADASAN",
                    "document_number": "TN22 2017 0006055",
                    "issue_date": "2017-07-06"
                }
            }
        },
        "declined_reason": null,
        "declined_reasons_list": []
    },
    "requested_at": "2023-12-14T07:43:38.457Z",
    "completed_at": "2023-12-14T07:50:45.300Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid email adddress",
        "field": "email",
        "code": "BAD_REQUEST"
    }
}