Aadhaar Card

This API helps you fetch the Digilocker-verified documents for your customers. End users need not have a Digilocker account in advance to fetch the documents. If an individual does not have a Digilocker account, we will create an account on the go and fetch the documents. Experience for both types of customers will be exactly the same.

Submit Document

ind_aadhaar

POST https://secctrl.tutelar.io/api/v1/kyc/identity/ind_aadhaar

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
callback_url	String	Yes	Your Webhook URL

Sample Post Parameters

{
    "callback_url": "https://secctrl.tutelar.io/api/v1/callback"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Enter a valid callback URL",
        "field": "callback_url",
        "code": "BAD_REQUEST"
    }
}

Check Document Status

Get document details

GET https://secctrl.tutelar.io/api/v1/kyc/identity/ind_aadhaar

Query parameters description is given below,

Query Parameter	Type	Is Mandatory	Description
reference_id	String	Yes	Document reference id

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "17283ba4-5744-4d70-ad93-914b57c40e32",
    "status": "completed",
    "result": {
        "document_number": "xxxxxxxx3403",
        "name_on_document": "Bharathithasan Rajkumar",
        "gender": "MALE",
        "date_of_birth": "1997-07-08",
        "mobile_number": "UNAVAILABLE",
        "address": "S/O: Rajkumar D NO 144/ 6 MULLAI NAGAR 4 CROSS Salem Salem Tamil Nadu 636005",
        "city": "Salem",
        "pin_code": "636005",
        "district": "Salem",
        "state": "TAMIL NADU",
        "country": "INDIA",
        "land_mark": "SURAMANGALAM",
        "photo": "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",
        "download_url": "https://persist.signzy.tech/api/files/889119618/download/f13ed43a7227454982c54c85d15b2174328003b73be349f0b6e4e84558b8fdb6.xml",
        "file_format": "xml"
    },
    "requested_at": "2024-04-22T09:52:08.038Z",
    "completed_at": "2024-04-22T09:53:38.861Z"
}

200: Inprogress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "17283ba4-5744-4d70-ad93-914b57c40e32",
    "status": "in_progress",
    "result": {
        "redirect_url": "https://api.digitallocker.gov.in/public/oauth2/1/authorize?client_id=3DF9D55E&code_challenge=iZPXPoiPRyt9RmWvo5bXc1srbyXsEE77Whko3A54TGQ&code_challenge_method=S256&dl_flow&pla&redirect_uri=https%3A%2F%2Fdigilocker.signzy.tech%2Fdigilocker-auth-complete&response_type=code&state=6626334874538e0024aa9daf",
        "session_exists": false
    },
    "requested_at": "2024-04-22T09:52:08.038Z"
}