Offsite Verification

offsite_document_verification

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

Post parameters description is given below,

Post Parameter

Type

Is Mandatory

Description

String

Yes

Email Address

country

String

Yes

Country Code

selfie_image

String

Yes

Selfie Image Url or Base64 String

front_image

String

Yes

Image Url or Base64 String

back_image

String

Yes

Image Url or Base64 String

Sample Post Parameters

{
    "email": "[email protected]",
    "country": "IN",
    "selfie_image": "Image URL/Base64 String",
    "document": {
        "front_image": "Image URL/Base64 String",
        "back_image": "Image URL/Base64 String"
    }
}

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "dcb33864-9cb4-4da0-84ea-8865e98fa02b",
    "result": {
        "verification_status": "accepted",
        "email": "[email protected]",
        "country": "IN",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "Dhanushraja Devadasan"
                },
                "dob": "1994-01-01",
                "expiry_date": null,
                "issue_date": null,
                "document_number": "290164903705",
                "selected_type": [
                    "id_card"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 73
            }
        },
        "verification_result": {
            "face": 1,
            "document": {
                "document": 1,
                "document_visibility": 1,
                "document_must_not_be_expired": 1,
                "document_proof": 1,
                "selected_type": 1,
                "document_country": 1,
                "face_on_document_matched": 1,
                "name": 1,
                "document_number": 1,
                "dob": 1,
                "issue_date": null,
                "expiry_date": null
            }
        },
        "info": {
            "agent": {
                "is_desktop": true,
                "is_phone": false,
                "useragent": "undici",
                "device_name": "0",
                "browser_name": "",
                "platform_name": ""
            },
            "geolocation": {
                "host": "ec2-13-126-207-211.ap-south-1.compute.amazonaws.com",
                "ip": "13.126.207.211",
                "rdns": "13.126.207.211",
                "asn": "16509",
                "isp": "amazon.com Inc",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Maharashtra",
                "region_code": "MH",
                "city": "Powai",
                "postal_code": "400070",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "19.076000213623",
                "longitude": "72.877700805664",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "document_number": "290164903705",
                    "face": "261,447,440,656",
                    "gender": "M",
                    "full_name": "Dhanushraja Devadasan",
                    "full_name_native": "தனுஷ்ராஜா தேவதாசன்",
                    "country": "INDIA",
                    "country_code": "IN",
                    "document_type": "IDENTIFICATION CARD",
                    "document_official_name": "Aadhaar V7",
                    "document_country": "India",
                    "document_country_code": "IN",
                    "first_name": "Dhanushraja",
                    "middle_name": "Devadasan"
                },
                "additional_proof": {
                    "document_number": "290164903705",
                    "address": "S O Devadasan 1596 ALAIYAMMAN KOVIL 1st STREET AMBETHKAR nagarmannivakkam EXTENSION Mannivakkam Mannivakkam Kancheepuram Chengalpattu Tamil Nadu 600048",
                    "address_native": "முகவரி தேவதாசன் 1/596 ஆலையம்மன் கோயில் 1 வது தெரு அம்பேத்கார் நகர் ண்ணிவாக்கம் விரவு மண்ணிவாக்கம் மண்ணிவாக்கம் காஞ்சிபுரம் தமிழ் நாடு . 600048",
                    "document_country": "India",
                    "document_country_code": "IN",
                    "document_official_name": "India ID Card v7"
                }
            }
        },
        "declined_reason":null,
        "declined_reasons_list": []
    },
    "requested_at": "2023-11-27T13:04:38.957Z",
    "completed_at": "2023-11-27T13:05:09.669Z"
}

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "c53e8d38-104e-498b-bf77-503d16d7f6d0",
    "result": {
        "verification_status": "declined",
        "email": "[email protected]",
        "country": "QA",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "ANDRE SNOXALLEWIDY"
                },
                "dob": "1960",
                "expiry_date": null,
                "issue_date": null,
                "document_number": "26082",
                "selected_type": [
                    "driving_license"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 94
            }
        },
        "verification_result": {
            "face": 0,
            "document": {
                "document": null,
                "document_visibility": 1,
                "document_must_not_be_expired": null,
                "document_proof": null,
                "selected_type": 1,
                "document_country": 1,
                "face_on_document_matched": 1,
                "name": 1,
                "document_number": 1,
                "dob": 1,
                "issue_date": null,
                "expiry_date": null
            }
        },
        "info": {
            "agent": {
                "is_desktop": true,
                "is_phone": false,
                "useragent": "undici",
                "device_name": "0",
                "browser_name": "",
                "platform_name": ""
            },
            "geolocation": {
                "host": "ec2-13-126-207-211.ap-south-1.compute.amazonaws.com",
                "ip": "13.126.207.211",
                "rdns": "13.126.207.211",
                "asn": "16509",
                "isp": "amazon.com Inc",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Maharashtra",
                "region_code": "MH",
                "city": "Powai",
                "postal_code": "400070",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "19.076000213623",
                "longitude": "72.877700805664",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "face": "779,323,1013,597",
                    "nationality": "17/01/2013",
                    "occupation": "استشاري فني",
                    "full_name": " ANDRE SNOXALLEWIDY",
                    "full_name_native": "اندري مارك فيليب سنوكسل",
                    "document_official_name": "Qatar Residence Permit v1",
                    "gender": "M",
                    "document_country": "Qatar",
                    "document_country_code": "QA",
                    "first_name": "Andre",
                    "middle_name": "Mark",
                    "last_name": "Snoxall",
                    "document_number": "26082"
                }
            }
        },
        "declined_reason": "Face proof has a solid color in the background",
        "declined_reasons_list": [
            "Face proof has a solid color in the background"
        ]
    },
    "requested_at": "2023-12-14T07:08:06.179Z",
    "completed_at": "2023-12-14T07:08:58.794Z"
}

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "9a5f67ca-e01f-4fed-82c6-e949c9851b53",
    "result": {
        "verification_status": "declined",
        "email": "[email protected]",
        "country": "AE",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "DOE JOHN LE"
                },
                "dob": "1986-10-16",
                "expiry_date": "2023-12-15",
                "issue_date": "2018-12-15",
                "document_number": "C12345678",
                "selected_type": [
                    "passport"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 68
            }
        },
        "verification_result": {
            "face": 0,
            "document": {
                "document": null,
                "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,
                "useragent": "undici",
                "device_name": "0",
                "browser_name": "",
                "platform_name": ""
            },
            "geolocation": {
                "host": "ec2-13-126-207-211.ap-south-1.compute.amazonaws.com",
                "ip": "13.126.207.211",
                "rdns": "13.126.207.211",
                "asn": "16509",
                "isp": "amazon.com Inc",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Maharashtra",
                "region_code": "MH",
                "city": "Powai",
                "postal_code": "400070",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "19.076000213623",
                "longitude": "72.877700805664",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "mrz": "UNITED P < A REDOE << JOHN < LE <<<<<<<<<<<< C123456788ARE86101642312156 <<<<<<<<<<<<<<< 2 <<<<<<<<",
                    "place_of_birth": "ABU DHABI",
                    "issue_date": "2018-12-15",
                    "document_number": "C12345678",
                    "authority": "ABU DHABI",
                    "face": "146,709,352,1036",
                    "document_type": "P",
                    "signature": "754,1074,860,1116",
                    "expiry_date": "2023-12-15",
                    "place_of_birth_native": "مكان النبيلة",
                    "country_code": "ARE",
                    "dob": "1986-10-16",
                    "nationality": "United Arab Emirates",
                    "nationality_native": "الإمارات العربية المتحدة",
                    "gender_native": "ذكر",
                    "gender": "M",
                    "full_name": "DOE JOHN LE",
                    "document_country": "United Arab Emirates",
                    "document_country_code": "AE",
                    "document_official_name": "United Arab Emirates Passport",
                    "last_name": "LE"
                }
            }
        },
        "declined_reason": "Face proof has a solid color in the background",
        "declined_reasons_list": [
            "Face proof has a solid color in the background"
        ]
    },
    "requested_at": "2023-12-08T12:36:14.915Z",
    "completed_at": "2023-12-08T12:37:44.003Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "91084d90-4468-43c8-b537-cd7a69d2e2b1",
    "status": "in_progress",
    "requested_at": "2026-02-24T14:40:18.115Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "76d049e8-e9eb-4095-8926-74235763cf8a",
    "status": "failed",
    "error": {
        "message": "Verification Failed.",
        "code": "ERROR"
    },
    "requested_at": "2024-03-18T05:12:26.884Z",
    "completed_at": "2024-03-18T05:12:27.305Z"
}

{
    "success": false,
    "code": 400,
    "message": "Email should not be empty",
    "error": {
        "message": "Email should not be empty",
        "field": "email",
        "code": "BAD_REQUEST"
    }
}

Check Document Status

Get document details

This Get details API using to fetch the latest updated response when the above API gave the status as in-progress by using the reference_id

GET https://secctrl.tutelar.io/api/v1/kyc/vision/offsite_document_verification

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Document reference id

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "dcb33864-9cb4-4da0-84ea-8865e98fa02b",
    "result": {
        "verification_status": "accepted",
        "email": "[email protected]",
        "country": "IN",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "Dhanushraja Devadasan"
                },
                "dob": "1994-01-01",
                "expiry_date": null,
                "issue_date": null,
                "document_number": "290164903705",
                "selected_type": [
                    "id_card"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 73
            }
        },
        "verification_result": {
            "face": 1,
            "document": {
                "document": 1,
                "document_visibility": 1,
                "document_must_not_be_expired": 1,
                "document_proof": 1,
                "selected_type": 1,
                "document_country": 1,
                "face_on_document_matched": 1,
                "name": 1,
                "document_number": 1,
                "dob": 1,
                "issue_date": null,
                "expiry_date": null
            }
        },
        "info": {
            "agent": {
                "is_desktop": true,
                "is_phone": false,
                "useragent": "undici",
                "device_name": "0",
                "browser_name": "",
                "platform_name": ""
            },
            "geolocation": {
                "host": "ec2-13-126-207-211.ap-south-1.compute.amazonaws.com",
                "ip": "13.126.207.211",
                "rdns": "13.126.207.211",
                "asn": "16509",
                "isp": "amazon.com Inc",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Maharashtra",
                "region_code": "MH",
                "city": "Powai",
                "postal_code": "400070",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "19.076000213623",
                "longitude": "72.877700805664",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "document_number": "290164903705",
                    "face": "261,447,440,656",
                    "gender": "M",
                    "full_name": "Dhanushraja Devadasan",
                    "full_name_native": "தனுஷ்ராஜா தேவதாசன்",
                    "country": "INDIA",
                    "country_code": "IN",
                    "document_type": "IDENTIFICATION CARD",
                    "document_official_name": "Aadhaar V7",
                    "document_country": "India",
                    "document_country_code": "IN",
                    "first_name": "Dhanushraja",
                    "middle_name": "Devadasan"
                },
                "additional_proof": {
                    "document_number": "290164903705",
                    "address": "S O Devadasan 1596 ALAIYAMMAN KOVIL 1st STREET AMBETHKAR nagarmannivakkam EXTENSION Mannivakkam Mannivakkam Kancheepuram Chengalpattu Tamil Nadu 600048",
                    "address_native": "முகவரி தேவதாசன் 1/596 ஆலையம்மன் கோயில் 1 வது தெரு அம்பேத்கார் நகர் ண்ணிவாக்கம் விரவு மண்ணிவாக்கம் மண்ணிவாக்கம் காஞ்சிபுரம் தமிழ் நாடு . 600048",
                    "document_country": "India",
                    "document_country_code": "IN",
                    "document_official_name": "India ID Card v7"
                }
            }
        },
        "declined_reason":null,
        "declined_reasons_list": []
    },
    "requested_at": "2023-11-27T13:04:38.957Z",
    "completed_at": "2023-11-27T13:05:09.669Z"
}

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "c53e8d38-104e-498b-bf77-503d16d7f6d0",
    "result": {
        "verification_status": "declined",
        "email": "[email protected]",
        "country": "QA",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "ANDRE SNOXALLEWIDY"
                },
                "dob": "1960",
                "expiry_date": null,
                "issue_date": null,
                "document_number": "26082",
                "selected_type": [
                    "driving_license"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 94
            }
        },
        "verification_result": {
            "face": 0,
            "document": {
                "document": null,
                "document_visibility": 1,
                "document_must_not_be_expired": null,
                "document_proof": null,
                "selected_type": 1,
                "document_country": 1,
                "face_on_document_matched": 1,
                "name": 1,
                "document_number": 1,
                "dob": 1,
                "issue_date": null,
                "expiry_date": null
            }
        },
        "info": {
            "agent": {
                "is_desktop": true,
                "is_phone": false,
                "useragent": "undici",
                "device_name": "0",
                "browser_name": "",
                "platform_name": ""
            },
            "geolocation": {
                "host": "ec2-13-126-207-211.ap-south-1.compute.amazonaws.com",
                "ip": "13.126.207.211",
                "rdns": "13.126.207.211",
                "asn": "16509",
                "isp": "amazon.com Inc",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Maharashtra",
                "region_code": "MH",
                "city": "Powai",
                "postal_code": "400070",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "19.076000213623",
                "longitude": "72.877700805664",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "face": "779,323,1013,597",
                    "nationality": "17/01/2013",
                    "occupation": "استشاري فني",
                    "full_name": " ANDRE SNOXALLEWIDY",
                    "full_name_native": "اندري مارك فيليب سنوكسل",
                    "document_official_name": "Qatar Residence Permit v1",
                    "gender": "M",
                    "document_country": "Qatar",
                    "document_country_code": "QA",
                    "first_name": "Andre",
                    "middle_name": "Mark",
                    "last_name": "Snoxall",
                    "document_number": "26082"
                }
            }
        },
        "declined_reason": "Face proof has a solid color in the background",
        "declined_reasons_list": [
            "Face proof has a solid color in the background"
        ]
    },
    "requested_at": "2023-12-14T07:08:06.179Z",
    "completed_at": "2023-12-14T07:08:58.794Z"
}

{
    "success": true,
    "code": 200,
    "message": "Document verification completed successfully.",
    "status": "completed",
    "reference_id": "9a5f67ca-e01f-4fed-82c6-e949c9851b53",
    "result": {
        "verification_status": "declined",
        "email": "[email protected]",
        "country": "AE",
        "verification_data": {
            "document": {
                "name": {
                    "first_name": null,
                    "middle_name": null,
                    "last_name": null,
                    "full_name": "DOE JOHN LE"
                },
                "dob": "1986-10-16",
                "expiry_date": "2023-12-15",
                "issue_date": "2018-12-15",
                "document_number": "C12345678",
                "selected_type": [
                    "passport"
                ],
                "supported_types": [
                    "id_card",
                    "driving_license",
                    "passport",
                    "credit_or_debit_card"
                ],
                "face_match_confidence": 68
            }
        },
        "verification_result": {
            "face": 0,
            "document": {
                "document": null,
                "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,
                "useragent": "undici",
                "device_name": "0",
                "browser_name": "",
                "platform_name": ""
            },
            "geolocation": {
                "host": "ec2-13-126-207-211.ap-south-1.compute.amazonaws.com",
                "ip": "13.126.207.211",
                "rdns": "13.126.207.211",
                "asn": "16509",
                "isp": "amazon.com Inc",
                "country_name": "India",
                "country_code": "IN",
                "region_name": "Maharashtra",
                "region_code": "MH",
                "city": "Powai",
                "postal_code": "400070",
                "continent_name": "Asia",
                "continent_code": "AS",
                "latitude": "19.076000213623",
                "longitude": "72.877700805664",
                "metro_code": "",
                "timezone": "Asia/Kolkata",
                "ip_type": "ipv4",
                "capital": "New Delhi",
                "currency": "INR"
            }
        },
        "additional_data": {
            "document": {
                "proof": {
                    "mrz": "UNITED P < A REDOE << JOHN < LE <<<<<<<<<<<< C123456788ARE86101642312156 <<<<<<<<<<<<<<< 2 <<<<<<<<",
                    "place_of_birth": "ABU DHABI",
                    "issue_date": "2018-12-15",
                    "document_number": "C12345678",
                    "authority": "ABU DHABI",
                    "face": "146,709,352,1036",
                    "document_type": "P",
                    "signature": "754,1074,860,1116",
                    "expiry_date": "2023-12-15",
                    "place_of_birth_native": "مكان النبيلة",
                    "country_code": "ARE",
                    "dob": "1986-10-16",
                    "nationality": "United Arab Emirates",
                    "nationality_native": "الإمارات العربية المتحدة",
                    "gender_native": "ذكر",
                    "gender": "M",
                    "full_name": "DOE JOHN LE",
                    "document_country": "United Arab Emirates",
                    "document_country_code": "AE",
                    "document_official_name": "United Arab Emirates Passport",
                    "last_name": "LE"
                }
            }
        },
        "declined_reason": "Face proof has a solid color in the background",
        "declined_reasons_list": [
            "Face proof has a solid color in the background"
        ]
    },
    "requested_at": "2023-12-08T12:36:14.915Z",
    "completed_at": "2023-12-08T12:37:44.003Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "91084d90-4468-43c8-b537-cd7a69d2e2b1",
    "status": "in_progress",
    "requested_at": "2026-02-24T14:40:18.115Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "76d049e8-e9eb-4095-8926-74235763cf8a",
    "status": "failed",
    "error": {
        "message": "Verification Failed.",
        "code": "ERROR"
    },
    "requested_at": "2024-03-18T05:12:26.884Z",
    "completed_at": "2024-03-18T05:12:27.305Z"
}

{
    "success": false,
    "code": 400,
    "message": "Email should not be empty",
    "error": {
        "message": "Email should not be empty",
        "field": "email",
        "code": "BAD_REQUEST"
    }
}

PreviousOnsite Verification NextFace Match

Last updated 6 days ago

hashtagoffsite_document_verification

hashtagPost parameters description is given below,

hashtagSample Post Parameters

hashtagCheck Document Status

hashtagGet document details

hashtagQuery parameters description is given below,

offsite_document_verification

Post parameters description is given below,

Sample Post Parameters

Check Document Status

Get document details

Query parameters description is given below,