curl --request POST \
--url https://sandbox.cashfree.com/verification/vehicle-rc \
--header 'Content-Type: application/json' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '
{
"verification_id": "test001",
"vehicle_number": "PY01MW8769"
}
'import requests
url = "https://sandbox.cashfree.com/verification/vehicle-rc"
payload = {
"verification_id": "test001",
"vehicle_number": "PY01MW8769"
}
headers = {
"x-client-id": "<api-key>",
"x-client-secret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-client-id': '<api-key>',
'x-client-secret': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({verification_id: 'test001', vehicle_number: 'PY01MW8769'})
};
fetch('https://sandbox.cashfree.com/verification/vehicle-rc', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.cashfree.com/verification/vehicle-rc",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'verification_id' => 'test001',
'vehicle_number' => 'PY01MW8769'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-client-id: <api-key>",
"x-client-secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.cashfree.com/verification/vehicle-rc"
payload := strings.NewReader("{\n \"verification_id\": \"test001\",\n \"vehicle_number\": \"PY01MW8769\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-client-id", "<api-key>")
req.Header.Add("x-client-secret", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.cashfree.com/verification/vehicle-rc")
.header("x-client-id", "<api-key>")
.header("x-client-secret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"verification_id\": \"test001\",\n \"vehicle_number\": \"PY01MW8769\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.cashfree.com/verification/vehicle-rc")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"verification_id\": \"test001\",\n \"vehicle_number\": \"PY01MW8769\"\n}"
response = http.request(request)
puts response.read_body{
"verification_id": "6c617137-6d50-4c59-9302-c453ca42aa8589",
"reference_id": 88,
"status": "VALID",
"reg_no": "PY01MW8675",
"class": "Motor Car",
"chassis": "XDLKHK511VKL59924",
"engine": "L5LCFF4579076",
"vehicle_manufacturer_name": "HYUNDAI MOTOR INDIA LTD",
"model": "PORCHE GDI DCT",
"vehicle_colour": "TITAN GREY",
"type": "PETROL",
"norms_type": "BHARAT STAGE VI",
"body_type": "HATCHBACK",
"owner_count": "1",
"owner": "JOHN DOE",
"owner_father_name": "JOHN DOE",
"mobile_number": null,
"rc_status": "ACTIVE",
"status_as_on": "19/01/2024",
"reg_authority": "BENGALURU CENTRAL RTO, Karnataka",
"reg_date": "24/12/2021",
"vehicle_manufacturing_month_year": "12/2021",
"rc_expiry_date": "23/12/2036",
"vehicle_tax_upto": null,
"vehicle_insurance_company_name": "BAJAJ INSURANCE CO. LTD.",
"vehicle_insurance_upto": "14/12/2024",
"vehicle_insurance_policy_number": "62000344820000",
"rc_financer": "BAJAJ FINANCE",
"present_address": "D-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103",
"split_present_address": {
"district": [
"BANGALORE"
],
"state": [
[
"KARNATAKA",
"KA"
]
],
"city": [
"BELLANDUR"
],
"pincode": "560103",
"country": [
"IN",
"IND",
"INDIA"
],
"address_line": "D-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103"
},
"permanent_address": "D-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103",
"split_permanent_address": {
"district": [
"BANGALORE"
],
"state": [
"KARNATAKA",
"KA"
],
"city": [
"BELLANDUR"
],
"pincode": "560103",
"country": [
"IN",
"IND",
"INDIA"
],
"address_line": "FD-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103"
},
"vehicle_cubic_capacity": "998",
"gross_vehicle_weight": "1490",
"unladen_weight": "1086",
"vehicle_category": "LMV",
"rc_standard_cap": "0",
"vehicle_cylinders_no": "3",
"vehicle_seat_capacity": "5",
"vehicle_sleeper_capacity": "0",
"vehicle_standing_capacity": "0",
"wheelbase": "2580",
"vehicle_number": "PY01MW5890",
"pucc_number": "Newv4",
"pucc_upto": "23/12/2022",
"blacklist_status": "NA",
"blacklist_details": null,
"challan_details": null,
"permit_issue_date": null,
"permit_number": null,
"permit_type": null,
"permit_valid_from": null,
"permit_valid_upto": null,
"non_use_status": null,
"non_use_from": null,
"non_use_to": null,
"national_permit_number": null,
"national_permit_upto": null,
"national_permit_issued_by": null,
"is_commercial": false,
"noc_details": null
}Verify Vehicle RC Details
Use this API to verify whether the vehicle information passed in the request is valid.
View the test data and use the information to trigger the validations. The test data can be used only in the sandbox environment.
curl --request POST \
--url https://sandbox.cashfree.com/verification/vehicle-rc \
--header 'Content-Type: application/json' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '
{
"verification_id": "test001",
"vehicle_number": "PY01MW8769"
}
'import requests
url = "https://sandbox.cashfree.com/verification/vehicle-rc"
payload = {
"verification_id": "test001",
"vehicle_number": "PY01MW8769"
}
headers = {
"x-client-id": "<api-key>",
"x-client-secret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-client-id': '<api-key>',
'x-client-secret': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({verification_id: 'test001', vehicle_number: 'PY01MW8769'})
};
fetch('https://sandbox.cashfree.com/verification/vehicle-rc', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.cashfree.com/verification/vehicle-rc",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'verification_id' => 'test001',
'vehicle_number' => 'PY01MW8769'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-client-id: <api-key>",
"x-client-secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.cashfree.com/verification/vehicle-rc"
payload := strings.NewReader("{\n \"verification_id\": \"test001\",\n \"vehicle_number\": \"PY01MW8769\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-client-id", "<api-key>")
req.Header.Add("x-client-secret", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.cashfree.com/verification/vehicle-rc")
.header("x-client-id", "<api-key>")
.header("x-client-secret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"verification_id\": \"test001\",\n \"vehicle_number\": \"PY01MW8769\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.cashfree.com/verification/vehicle-rc")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"verification_id\": \"test001\",\n \"vehicle_number\": \"PY01MW8769\"\n}"
response = http.request(request)
puts response.read_body{
"verification_id": "6c617137-6d50-4c59-9302-c453ca42aa8589",
"reference_id": 88,
"status": "VALID",
"reg_no": "PY01MW8675",
"class": "Motor Car",
"chassis": "XDLKHK511VKL59924",
"engine": "L5LCFF4579076",
"vehicle_manufacturer_name": "HYUNDAI MOTOR INDIA LTD",
"model": "PORCHE GDI DCT",
"vehicle_colour": "TITAN GREY",
"type": "PETROL",
"norms_type": "BHARAT STAGE VI",
"body_type": "HATCHBACK",
"owner_count": "1",
"owner": "JOHN DOE",
"owner_father_name": "JOHN DOE",
"mobile_number": null,
"rc_status": "ACTIVE",
"status_as_on": "19/01/2024",
"reg_authority": "BENGALURU CENTRAL RTO, Karnataka",
"reg_date": "24/12/2021",
"vehicle_manufacturing_month_year": "12/2021",
"rc_expiry_date": "23/12/2036",
"vehicle_tax_upto": null,
"vehicle_insurance_company_name": "BAJAJ INSURANCE CO. LTD.",
"vehicle_insurance_upto": "14/12/2024",
"vehicle_insurance_policy_number": "62000344820000",
"rc_financer": "BAJAJ FINANCE",
"present_address": "D-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103",
"split_present_address": {
"district": [
"BANGALORE"
],
"state": [
[
"KARNATAKA",
"KA"
]
],
"city": [
"BELLANDUR"
],
"pincode": "560103",
"country": [
"IN",
"IND",
"INDIA"
],
"address_line": "D-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103"
},
"permanent_address": "D-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103",
"split_permanent_address": {
"district": [
"BANGALORE"
],
"state": [
"KARNATAKA",
"KA"
],
"city": [
"BELLANDUR"
],
"pincode": "560103",
"country": [
"IN",
"IND",
"INDIA"
],
"address_line": "FD-901 Sun APARTMENTS, SARJAPUR, Bangalore, Karnataka, 560103"
},
"vehicle_cubic_capacity": "998",
"gross_vehicle_weight": "1490",
"unladen_weight": "1086",
"vehicle_category": "LMV",
"rc_standard_cap": "0",
"vehicle_cylinders_no": "3",
"vehicle_seat_capacity": "5",
"vehicle_sleeper_capacity": "0",
"vehicle_standing_capacity": "0",
"wheelbase": "2580",
"vehicle_number": "PY01MW5890",
"pucc_number": "Newv4",
"pucc_upto": "23/12/2022",
"blacklist_status": "NA",
"blacklist_details": null,
"challan_details": null,
"permit_issue_date": null,
"permit_number": null,
"permit_type": null,
"permit_valid_from": null,
"permit_valid_upto": null,
"non_use_status": null,
"non_use_from": null,
"non_use_to": null,
"national_permit_number": null,
"national_permit_upto": null,
"national_permit_issued_by": null,
"is_commercial": false,
"noc_details": null
}Authorizations
Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.
The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.
Headers
Send the signature if two-factor authentication is selected as Public Key. More details.
Body
Find the request parameters to retrieve the information of a vehicle's registration certificate.
It is the unique ID you create to identify the verification request. The maximum character limit is 50. Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.
"test001"
It is the registration number of the vehicle.
"PY01MW8769"
Response
Success response for retrieving vehicle's registration certification information.
It displays the unique ID you created to identify the verification request.
"6c617137-6d50-4c59-9302-c453ca42aa8589"
It displays the unique ID created by Cashfree for reference purposes.
format: int64
88
It displays the status of the vehicle rc. Possible values are
VALID: vehicle rc is valid.INVALID: vehicle rc is invalid.
"VALID"
It displays the registration number of the vehicle.
"KA01MW6127"
It displays the category or type of the vehicle as recognised by the relevant transportation authorities.
"Motor Car"
It displays the chassis information of the vehicle.
"MALBK511VMM110528"
It displays the engine number of the vehicle.
"G3LCMM440323"
It displays the manufacturer of the vehicle.
"HYUNDAI MOTOR INDIA LTD"
It displays the model number of the vehicle.
"I20 N LINE N8 1.0TURBO GDI DCT"
It displays the colour of the vehicle.
"TITAN GREY"
It displays the type of the vehicle.
"PETROL"
It displays the norms set by the Central Pollution Control Board (CPCB).
"BHARAT STAGE VI"
It displays the body type of the vehicle.
"HATCHBACK"
It displays the number of owners of the vehicle.
"1"
It displays the name of the current owner of the vehicle.
"RAGHAV RASTOGI"
It displays the father's name of the current owner of the vehicle.
"ROHIT RASTOGI"
It displays the mobile number of the current owner of the vehicle.
""
It displays the status of the RC.
"ACTIVE"
It displays the particular date of the status of the RC.
"19/01/2024"
It displays the name of the registration authority.
"BENGALURU CENTRAL RTO, Karnataka"
It displays the date of registration of the vehicle.
"24/12/2021"
It displays the month and year of the manufacturing of the vehicle.
"12/2021"
It displays the date until which the registration of the vehicle is valid.
"23/12/2036"
It displays the date until which the tax paid by the owner for the vehicle is valid.
""
It displays the name of the insurance company associated with the vehicle.
"TATA AIG GENERAL INSURANCE CO. LTD."
It displays the date until which the insurance paid by the owner for the vehicle is valid.
"14/12/2024"
It displays the insurance policy number of the vehicle.
"62000344820000"
It displays the name of the financial institution or lender that provided financing for the purchase of a vehicle.
"BANDHAN BANK"
It displays the current address of the owner of the vehicle.
"FLAT # 901 A BLOCK GOYAL ORCHID, LAKE VIEW APTS KARIAGRAHARA, BELLANDUR, Bangalore, Karnataka, 560103"
It containts the address information in individual components.
Show child attributes
Show child attributes
{
"value": {
"district": ["BANGALORE"],
"state": ["KARNATAKA", "KA"],
"city": ["BELLANDUR"],
"pincode": "560103",
"country": ["IN", "IND", "INDIA"],
"address_line": "FLAT 901 A BLOCK GOYAL ORCHID,LAKE VIEW APTS KARIAGRAHARA"
}
}
It displays the permanent address of the owner of the vehicle.
"FLAT # 901 A BLOCK GOYAL ORCHID, LAKE VIEW APTS KARIAGRAHARA, BELLANDUR, Bangalore, Karnataka, 560103"
It containts the address information in individual components.
Show child attributes
Show child attributes
{
"value": {
"district": ["BANGALORE"],
"state": ["KARNATAKA", "KA"],
"city": ["BELLANDUR"],
"pincode": "560103",
"country": ["IN", "IND", "INDIA"],
"address_line": "FLAT 901 A BLOCK GOYAL ORCHID,LAKE VIEW APTS KARIAGRAHARA"
}
}
It displays the cubic capacity of the vehicle's engine.
"998"
It displays the gross weight of the vehicle in kilograms.
"1490"
It displays the weight of the vehicle without carrying any load in kiolgrams.
"1086"
It displays the category of the vehicle.
"LMV"
"0"
It displays the number of cylinders present in the vehicle.
"3"
It displays the number of seats in the vehicle.
"5"
It displays the number of beds available in the vehicle.
"0"
It displays the number of people that can stand in the vehicle.
"0"
It displays distance between the front and rear axles of a vehicle in mm.
"2580"
It displays the registration number of the vehicle.
"KA01MW6127"
It displays the Pollution Under Control Certificate (PUCC) number associated with vehicle.
"Newv4"
It displays till when the PUCC number is valid.
"23/12/2022"
It displays whether the vehicle is blacklisted.
"NA"
It displays the reasons for blacklisting the vehicle.
It displays traffic tickets or citations issued by traffic police or authorities for various traffic violations.
It displays when the relevant authorities granted permission or authorisation for a specific type of permit associated with the vehicle.
""
It displays the permit number of the vehicle.
""
It displays the type of permit issued to the vehicle.
""
It displays the beginning date of the issuance of permit.
""
It displays the end date of the permit.
""
It displays whether the vehicle owner or registrant declared that the vehicle is not in use for a certain period.
""
It displays the beginning date of the non use period.
""
It displays the end date of the non use period.
""
It displays the permit issued to the vehicle to go outside the home state carrying goods.
""
It displays the end date of the permit issued to the vechicle to go outside the home state carrying goods.
""
It displays the national permit issuer's name.
""
It displays whether the vehicle is for commercial purpose.
false
It displays the details of the no objection certificate.
""
Was this page helpful?