Verify Driving Licence Details

Use this API to verify the driving license of your customer. We retrieve details of the driving licence that includes the type of licence, issue date, expiry date, and more. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.

Authorizations

x-client-id · string · header · required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

x-client-secret · string · header · required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

x-cf-signature · string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request paramenters to retrieve your customer's driving license information

verification_id · string · default: test001 · required

It is the unique ID you create to identify the verification request. A maximum of 50 characters are allowed. Only alphanumeric, period (.), hyphen (-) and underscore ( _ ) are allowed.

Example:

"test001"

dl_number · string · default: KA0120198900984 · required

It is the driving licence number of the individual for verification.

Example:

"KA0120198900984"

dob · string · default: 1994-08-05 · required

It is the date of birth of the individual as present in the driving licence. The accepted format is YYYY-MM-DD.

Example:

"1994-08-05"

Response

200

application/json

Success response for retrieving the driving licence information

verification_id · string

It displays the unique ID you created to identify this API request.

Example:

"test001"

reference_id · integer

It displays the unique ID created by Cashfree Payments for reference purposes. format: int64

Example:

78

dl_number · string

It displays the unique number assigned to the driving licence.

Example:

"JK01FG8087"

dob · string

It displays the date of birth of the individual as present in the driving licence.

Example:

"2001-10-23"

status · string

It displays the status of the driving licence. Possible values are

• VALID: driving license is valid.
• INVALID: driving licence is invalid.

Example:

"VALID"

badge_details · object[]

It contains the...

Show child attributes

dl_validity · object

It contains the different information regarding the validity of the licence.

Show child attributes

details_of_driving_licence · object

It contains the details of the driving licence.

Show child attributes

Example:

{
  "value": {
    "date_of_issue": "10/05/2019",
    "date_of_last_transaction": null,
    "status": null,
    "last_transacted_at": null,
    "name": "JOHN DOE",
    "father_or_husband_name": "JOHN DOE",
    "address_list": [
      {
        "complete_address": "FLAT NO D-901 SUN,BELLANDUR, BANGALORE SOUTH,BANGALORE,KA 560103",
        "type": "permanent",
        "split_address": {
          "district": ["BANGALORE"],
          "state": ["KARNATAKA", "KA"],
          "city": ["BELLANDUR"],
          "pincode": "560103",
          "country": ["IN", "IND", "INDIA"],
          "address_line": "FLAT NO D-901 SUN,BELLANDUR, BANGALORE SOUTH,BANGALORE,KA 560103"
        }
      },
      {
        "complete_address": "FLAT NO D-901 SUN,BELLANDUR, BANGALORE SOUTH,BANGALORE,KA 560103",
        "type": "temporary",
        "split_address": {
          "district": ["BANGALORE"],
          "state": ["KARNATAKA", "KA"],
          "city": ["BELLANDUR"],
          "pincode": "560103",
          "country": ["IN", "IND", "INDIA"],
          "address_line": "FLAT NO D-901 SUN,BELLANDUR, BANGALORE SOUTH,BANGALORE,KA 560103"
        }
      }
    ],
    "address": "FLAT NO D-901 SUN,BELLANDUR, BANGALORE SOUTH,BANGALORE,KA 560103",
    "photo": "PHOTO_LINK.jpeg",
    "split_address": {
      "district": ["BANGALORE"],
      "state": [""],
      "city": ["BELLANDUR"],
      "pincode": "560103",
      "country": ["IN", "IND", "INDIA"],
      "address_line": "FLAT NO D-901 SUNCITY,BELLANDUR, BANGALORE SOUTH,BANGALORE,KA 560103",
      "cov_details": []
    }
  }
}