Driving License

This extraction can be used to verify the identity of the user and ensure that they are not attempting to use a false identity.

Submit Document

ind_driving_license_ocr

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

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
front_side	String	Yes	Image Url
back_side	String	No	Image Url

Sample Post Parameters

{
    "front_side": "Base64 or Url",
    "back_side": "Base64 or Url"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "4f23ca21-7399-42e5-be4f-c648b430df46",
    "status": "completed",
    "result": {
        "document_number": "TN0020160000762",
        "name_on_document": "VINAYAGAMOORTHY.T",
        "fathers_name": "THANGARAJ",
        "date_of_birth": "1997-12-13",
        "address": "ARR 6518",
        "state": "TamilNadu",
        "date_of_validity": "2036-02-08",
        "issue_dates": "09/02/2016",
        "type": []
    },
    "requested_at": "2024-04-22T06:49:40.058Z",
    "completed_at": "2024-04-22T06:49:42.896Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "2fd4c21f-478d-4e52-bdc1-87ac29cdb300",
    "status": "in_progress",
    "requested_at": "2024-04-22T06:15:03.375Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Upload the front image of Aadhar card",
        "field": "front_side",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "6cd240a6-36cf-4c6e-ba31-332deee72762",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T06:28:24.007Z",
    "completed_at": "2024-04-22T06:28:26.923Z"
}

Check Document Status

Get document details

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

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": "4f23ca21-7399-42e5-be4f-c648b430df46",
    "status": "completed",
    "result": {
        "document_number": "TN0020160000762",
        "name_on_document": "VINAYAGAMOORTHY.T",
        "fathers_name": "THANGARAJ",
        "date_of_birth": "1997-12-13",
        "address": "ARR 6518",
        "state": "TamilNadu",
        "date_of_validity": "2036-02-08",
        "issue_dates": "09/02/2016",
        "type": []
    },
    "requested_at": "2024-04-22T06:49:40.058Z",
    "completed_at": "2024-04-22T06:49:42.896Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "2fd4c21f-478d-4e52-bdc1-87ac29cdb300",
    "status": "in_progress",
    "requested_at": "2024-04-22T06:15:03.375Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "6cd240a6-36cf-4c6e-ba31-332deee72762",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T06:28:24.007Z",
    "completed_at": "2024-04-22T06:28:26.923Z"
}