API Documentation DH-Boss


Vehicle Blacklist Check API - DHBOSS API

The Vehicle Blacklist Check API provides a comprehensive service for verifying if a vehicle is listed in any blacklist or stolen vehicle registry. This API is crucial for organizations involved in vehicle sales, leasing, or insurance, as it helps in preventing fraud and ensuring compliance with legal requirements.

Features

  • Blacklist Verification: Check if a vehicle's registration number appears in any blacklist or stolen vehicle database.
  • Real-Time Data: Access the most current data to ensure accurate and up-to-date information.
  • Comprehensive Coverage: Query multiple databases to ensure thorough verification.
  • Easy Integration: Simple API endpoints for easy integration with existing systems.

API Endpoint

The main endpoint for the Vehicle Blacklist Check API is:

https://api.dhboss.com/apicall/vehicle_blacklist_check_api/

Request Parameters

  • vehicleId: The registration number of the vehicle to be checked. (e.g., ABC1234)
  • api_key: Your API key for authentication.

Sample Request

Here is an example of how to make a request to the Vehicle Blacklist Check API:

GET vehicle_blacklist_check_api/?vehicleId=DD01AA0000&apikeyfill=5********5

Response

The API returns a JSON response indicating whether the vehicle is blacklisted or not:

{ "code": 200, "status": "success", "response": { "status": "Expired", "regn_no": "DL01AA0000", "rto_name": "DELHI", "regn_dt": "09/07/2021", "owner_name": "Dummy Name", "owner_sr": "1", "blacklist_flag": "YES", "blacklist_status": "Locked by DELHI due to reason Pending Demand/Arr, Difference of fee in temporary registration fee paid at the time of registration and fees applicable as per G.S.R. 240 is due towards this vehicle" } }

Conclusion

The Vehicle Blacklist Check API is a valuable tool for verifying vehicle status and preventing fraud. By integrating this API into your system, you can enhance your operations and provide better services to your customers.

- docs.dhboss.com


GET/POST : vehicle_blacklist_check_api

What is needed to use this API and how it will work is described below -
Your Api Key : Get API In Profile & eKYC

Input Parameters Detail
Name Type Description Mandatory
vehicleId String {Enter Value} Yes
apikeyfill String {Enter Value} Yes

Output Parameters Detail
Name Type Description
code integer 200
status string success
response.status string Expired
response.regn_no string DL01AA0000
response.rto_name string DELHI
response.regn_dt string 09/07/2021
response.owner_name string Dummy Name
response.owner_sr string 1
response.blacklist_flag string YES
response.blacklist_status string Locked by DELHI due to reason Pending Demand/Arr, Difference of fee in temporary registration fee paid at the time of registration and fees applicable as per G.S.R. 240 is due towards this vehicle







Other Input Parameters Detail
{ "code": 200, "status": "success", "response": { "status": "Active", "regn_no": "DL01AA0000", "rto_name": "RTA DELHI", "regn_dt": "13/05/2015", "owner_name": "Dummy Name", "owner_sr": "0", "blacklist_flag": "NO", "blacklist_status": "Vehicle not blacklisted" } }
Name Type Description






Call API URL
https://api.dhboss.com/apicall/vehicle_blacklist_check_api/
API Call Request Parameters
vehicleId=value&apikeyfill=value                                                   
API Call Example Request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.dhboss.com/apicall/vehicle_blacklist_check_api/',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => 'vehicleId=DD01AA0000&apikeyfill=5********5',
 
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>
API Hit Example Response
{
  "code": 200,
  "status": "success",
  "response": {
    "status": "Expired",
    "regn_no": "DL01AA0000",
    "rto_name": "DELHI",
    "regn_dt": "09/07/2021",
    "owner_name": "Dummy Name",
    "owner_sr": "1",
    "blacklist_flag": "YES",
    "blacklist_status": "Locked by DELHI due to reason Pending Demand/Arr, Difference of fee in temporary registration fee paid at the time of registration and fees applicable as per G.S.R. 240 is due towards this vehicle"
  }
}