Aadhaar Pincode Geofencing OCR

Retrieve geofence matches using the Aadhaar image along with the provided latitude and longitude

aadhaar_pincode_geofencing

POST https://secctrl.tutelar.io/api/v2/kyc/vision/aadhaar_pincode_geofencing

Header

Name

Value

Content-Type

application/json

Authorization

Bearer eyJhbGciOiJ.....

Post parameters description is given below,

Post Parameter

Type

Is Mandatory

Description

file

png, jpg, jpeg

Yes

Aadhar Image to retrive the details

latitude

String

Yes

User latitude to identify the geofence Mathces

longitude

String

Yes

User longitude to identify the geofence Mathces

Sample Post Parameters

To call this API, you must send a POST request with multipart/form-data containing: 1. file → Aadhaar image (.jpg, .jpeg, or .png ) 2. latitude → Current latitude to compare geofence 3. longitude → Current longitude to compare geofence

--form 'file=@"/path/to/Aadhaar.JPG"' \
--form 'latitude="9.7"' \
--form 'longitude="77.4"'

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "f787a54a-e7c4-46af-9f20-f7a4f496ab4b",
    "status": "completed",
    "result": {
        "message": "Uploads matches with geofence",
        "extracted_pincode": "625512",
        "pincode_geo_location": {
            "latitude": 9.6,
            "longitude": 77.3
        },
        "user_location": {
            "latitude": 9.7,
            "longitude": 77.4
        },
        "distance": "1.4 km",
        "threshold_distance": "1.5 km",
        "matches": true
    },
    "requested_at": "2025-08-26T05:34:47.660Z",
    "completed_at": "2025-08-26T05:34:49.135Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "2d8d1069-cde7-4954-a8e9-3e7684152436",
    "status": "completed",
    "result": {
        "message": "Uploads doesn't match with geofence",
        "extracted_pincode": "625515",
        "pincode_geo_location": {
            "latitude": 9.842162,
            "longitude": 77.38276
        },
        "user_location": {
            "latitude": 9.7,
            "longitude": 77.4
        },
        "distance": "15.94 km",
        "threshold_distance": "1.5 km",
        "matches": false
    },
    "requested_at": "2025-08-26T06:07:13.425Z",
    "completed_at": "2025-08-26T06:07:14.857Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "c3d101d4-c9ec-48df-a25f-60354ec78c78",
    "status": "in_progress",
    "requested_at": "2024-04-22T04:47:39.590Z"
}

{
    "success": false,
    "code": 400,
    "message": "Only jpg/png types image are allowed",
    "error": {
        "message": "Invalid image type",
        "field": "file",
        "code": "BAD_REQUEST"
    }
}

{
    "success": false,
    "code": 400,
    "message": "File is required",
    "error": {
        "message": "Missing Aadhar Image!",
        "field": "file",
        "code": "BAD_REQUEST"
    }
}

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

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

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "2e3f87e4-7be9-425c-9161-59a2cb51abbd",
    "status": "failed",
    "error": {
        "message": "No valid 6-digit PIN found",
        "code": "ERROR"
    },
    "requested_at": "2025-08-26T06:04:04.004Z",
    "completed_at": "2025-08-26T06:04:04.632Z"
}

Check Document Status

Get document details

GET https://secctrl.tutelar.io/api/v2/kyc/vision/aadhaar_pincode_geofencing

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Document reference id

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "f787a54a-e7c4-46af-9f20-f7a4f496ab4b",
    "status": "completed",
    "result": {
        "message": "Uploads matches with geofence",
        "extracted_pincode": "625512",
        "pincode_geo_location": {
            "latitude": 9.6,
            "longitude": 77.3
        },
        "user_location": {
            "latitude": 9.7,
            "longitude": 77.4
        },
        "distance": "1.4 km",
        "threshold_distance": "1.5 km",
        "matches": true
    },
    "requested_at": "2025-08-26T05:34:47.660Z",
    "completed_at": "2025-08-26T05:34:49.135Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "c3d101d4-c9ec-48df-a25f-60354ec78c78",
    "status": "in_progress",
    "requested_at": "2024-04-22T04:47:39.590Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "2e3f87e4-7be9-425c-9161-59a2cb51abbd",
    "status": "failed",
    "error": {
        "message": "No valid 6-digit PIN found",
        "code": "ERROR"
    },
    "requested_at": "2025-08-26T06:04:04.004Z",
    "completed_at": "2025-08-26T06:04:04.632Z"
}

PreviousAadhaar Card OCR NextPan Card OCR

Last updated 1 month ago