Aadhaar Basic verification

Introduction

As an Aadhaar card is a bio-metric document that stores an individual’s details in a government database and is fast becoming the government’s base for public welfare and citizen services. And in Aadhar Extraction information present on Aadhaar will be extracted and which can be verified from user inputs or other sources.

Aadhar Extraction

Before going for Auto reading or Verification calls, you first need to create an Identity object. To get an overview of the ID verification process visit here .For best results, please make sure that the image you use fits tightly in camera view and is horizontally-aligned. Each image/pdf should be less than 2MB and expired image should not be uploaded.

Though this engine support extraction of images as well as pdf files, our test results indicate that there is much better accuracy and faster response time for image extraction. We would suggest you to pass only image file for better results. For pdf files extacrtion, you can use our pdf to image converter API and then pass the resulted image file in this extraction engine.Pdf to Image(JPG).

API Endpoint's

Identity Object

POST https://preproduction.signzy.tech/api/v2/patrons/<patron-id>/identities

POST https://signzy.tech/api/v2/patrons/<patron-id>/identities

Headers

Key	Value
Authorization	access token (returned as id field of login request)
Content-type	application/json

Request Data

{
    "type": "aadhaar",
    "email": "[email protected]",
    "callbackUrl": "https://your-domain.com/your-callback-system",
    "images": [
        "<urls-to-uploaded-files>", "<urls-to-uploaded-files>"
    ]
}

PARAMETERS	DESCRIPTION	TYPE	VALUE (COMPULSORY OR OPTIONAL)
type	Supported type parameter for creation of Identity objects individualPan businessPan aadhaar passport drivingLicence cheque voterid	String	COMPULSORY
email	E-mail can't be empty	String	COMPULSORY
callbackUrl	callbackUrl is where the data is posted on each activity performed on this Identity object.	String	COMPULSORY
images	urls's to be extracted	List	COMPULSORY

Response

{
              "type": "aadhaar",
              "email": "[email protected]",
              "callbackUrl": "https://your-domain.com/your-callback-system",
              "images": [
                "<urls-to-uploaded-files>","<urls-to-uploaded-files>"
              ],
              "autoRecognition": [],
              "verification": [],
              "forgeryCheck": [],
              "accessToken": "..access-token-for-the-snoop-request..",
              "id": "..itemId-for-the-snoop-request....",
              "patronId": "..your-id-into-signzy-system-(userId-returned-from-the-login-call).."
            }

Snoops

POST https://preproduction.signzy.tech/api/v2/snoops

POST https://signzy.tech/api/v2/snoops

Headers

Key	Value
Authorization	access token (returned as id field of login request)
Content-type	application/json

Request Data

{
    "service":"Identity",
    "itemId":"<..itemId-from-the-Identity-Object-request....>",
    "task":"basicVerifyAadhaar",
    "accessToken":"<..access-token-from-the-Identity-Object-request..>",
    "essentials":{
        "uid":"<Aadhaar-number>"
    }
}

PARAMETERS	DESCRIPTION	TYPE	VALUE (COMPULSORY OR OPTIONAL)
service	Category it belongs to	String	COMPULSORY
itemId	id parameter value returned from the Identity Object creation request.	String	COMPULSORY
task	Task can be autoRecognition verification fetch	String	COMPULSORY
accessToken	accessToken parameter value returned from the Identity Object creation request.	String	OPTIONAL
essentials.uid	aadhaar number to verify	Object	COMPULSORY

Response

{
    "service": "Identity",
    "itemId": "...id....",
    "task": '"autoRecognition"',
    "essentials": {},
    "accessToken": "...access token from identity request...",
    "id": "...id...",
    "response": {
        "result": {
            "verified": "...true/false...",
            "aadhaarNumber": "...aadhaarNumber..."
        }
    }
}