post
https://api.instantpay.in/identity/verifyDrivingLicense
The Driving License Verification API solution by Instantpay allows businesses to authenticate the validity of a driver's licence swiftly and accurately.
Employ this feature to enhance security measures, confirming the authenticity of driving licences during various transactions and interactions, contributing to a safer and more reliable operational environment.
Additionally, the API facilitates the extraction of personal information, including permissible types of vehicles, along with the provision of RTO-registered user photos, further enhancing the comprehensive verification process.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code is "1" (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client Id Provided by Instantpay | M | Y |
| X-Ipay-Client-Secret | String | Unique Client Secret Provided by Instantpay | M | Y |
| X-Ipay-Endpoint-Ip | String | End customer IP Address | M | Y |
Request Parameters
| Parameter Name | Type | Requirement | Description |
|---|---|---|---|
| drivingLicenseNumber | String | Mandatory | Driving License Number |
| dob | String | MAndatory | Date of birth linked with Driving License (format YYYY-MM-DD) |
| latitude | String | Mandatory | End Customer Latitude. |
| longitude | String | Mandatory | End Customer Longitude |
| externalRef | String | Mandatory | Your Unique Transaction id |
| consent | String | Mandatory | Consent should be accepted by customer |
Sample Request
curl --location 'https://api.instantpay.in/identity/verifyDrivingLicense' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data '{
"drivingLicenseNumber":"HR0620220012345",
"dob" : "01-01-2000",
"latitude" : {{$randomLatitude}},
"longitude" : {{$randomLongitude}},
"externalRef" : "{{random}}",
"consent" : "Y"
}'POST /identity/verifyDrivingLicense HTTP/2.1
Host: api.instantpay.in
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json
{
"drivingLicenseNumber":"HR0620220012345",
"dob" : "01-01-2000",
"latitude" : {{$randomLatitude}},
"longitude" : {{$randomLongitude}},
"externalRef" : "{{random}}",
"consent" : "Y"
}Response Parameters
| Parameter Name | Type | Description |
|---|---|---|
| statuscode | String | Instantpay Status Code |
| actcode | String | Action Code |
| status | Array | Status message |
| data | String | Response Data(if Present) |
| timestamp | String | Response time (YYYY-MM-DD HH:II:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id(if transaction otherwise it is null) |
| environment | String | Live/Sandbox |
| internalCode | String | It will be null |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"drivingLicenseDetail": {
"userAddress": [
{
"addressLine1": "Sample Address",
"completeAddress": "Full Address",
"country": "INDIA",
"district": "TAL-PANHALA,",
"pin": "",
"state": "Maharashtra",
"type": "Permanent"
},
{
"addressLine1": "Sample Address,",
"completeAddress": "Full Address",
"country": "INDIA",
"district": "TAL-PANHALA,",
"pin": "",
"state": "Maharashtra",
"type": "Present"
}
],
"userBloodGroup": "U",
"dlNumber": "GJ01AB4589",
"userDob": "01/01/2000",
"endorseDate": "",
"endorseNumber": "",
"expiryDate": "28/02/2020",
"fatherOrHusband": "Sample Name",
"issuedDate": "29/02/2000",
"nonTransportValidity": {
"from": "29/02/2000",
"to": "28/02/2020"
},
"state": "Maharashtra",
"status": "Active",
"statusDetails": {
"from": "",
"remarks": "",
"to": ""
},
"transportValidity": {
"from": "",
"to": ""
},
"userFullName": "Sample Name",
"userImage": "/9j/4AAQhAMVm9O1yXvI4ZgJVLbDIDyD/MVoweDyD2Q==",
"vehicleCategoryDetails": [
{
"cov": "MCWG",
"expiryDate": "",
"issueDate": ""
},
{
"cov": "LMV",
"expiryDate": "",
"issueDate": ""
}
]
},
"pool": {
"referenceId": "1000987654321EZFJY",
"openingBalance": "47.77",
"paymentAmount": "0.00",
"mode": "DR",
"closingBalance": "47.77"
}
},
"timestamp": "2023-10-05 10:21:15",
"ipay_uuid": "h06896097f63-XXXX-XXXX-XXXX-794c62d59494",
"orderid": "1000987654321EZFJY",
"environment": "LIVE",
"internalCode": null
}