Skip to main content
POST
/
vehicle-rc
Verify Vehicle RC Details
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

​
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 parameters to retrieve the information of a vehicle's registration certificate.

​
verification_id
string
default:test001
required

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.

Example:

"test001"

​
vehicle_number
string
required

It is the registration number of the vehicle.

Example:

"PY01MW8769"

Response

Success response for retrieving vehicle's registration certification information.

​
verification_id
string

It displays the unique ID you created to identify the verification request.

Example:

"6c617137-6d50-4c59-9302-c453ca42aa8589"

​
reference_id
integer

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

Example:

88

​
status
string

It displays the status of the vehicle rc. Possible values are

  • VALID: vehicle rc is valid.
  • INVALID: vehicle rc is invalid.
Example:

"VALID"

​
reg_no
string

It displays the registration number of the vehicle.

Example:

"KA01MW6127"

​
class
string

It displays the category or type of the vehicle as recognised by the relevant transportation authorities.

Example:

"Motor Car"

​
chassis
string

It displays the chassis information of the vehicle.

Example:

"MALBK511VMM110528"

​
engine
string

It displays the engine number of the vehicle.

Example:

"G3LCMM440323"

​
vehicle_manufacturer_name
string

It displays the manufacturer of the vehicle.

Example:

"HYUNDAI MOTOR INDIA LTD"

​
model
string

It displays the model number of the vehicle.

Example:

"I20 N LINE N8 1.0TURBO GDI DCT"

​
vehicle_color
string

It displays the colour of the vehicle.

Example:

"TITAN GREY"

​
type
string

It displays the type of the vehicle.

Example:

"PETROL"

​
norms_type
string

It displays the norms set by the Central Pollution Control Board (CPCB).

Example:

"BHARAT STAGE VI"

​
body_type
string

It displays the body type of the vehicle.

Example:

"HATCHBACK"

​
owner_count
string

It displays the number of owners of the vehicle.

Example:

"1"

​
owner
string

It displays the name of the current owner of the vehicle.

Example:

"RAGHAV RASTOGI"

​
owner_father_name
string

It displays the father's name of the current owner of the vehicle.

Example:

"ROHIT RASTOGI"

​
mobile_number
string

It displays the mobile number of the current owner of the vehicle.

Example:

""

​
rc_status
string

It displays the status of the RC.

Example:

"ACTIVE"

​
status_as_on
string

It displays the particular date of the status of the RC.

Example:

"19/01/2024"

​
reg_authority
string

It displays the name of the registration authority.

Example:

"BENGALURU CENTRAL RTO, Karnataka"

​
reg_date
string

It displays the date of registration of the vehicle.

Example:

"24/12/2021"

​
vehicle_manufacturing_month_year
string

It displays the month and year of the manufacturing of the vehicle.

Example:

"12/2021"

​
rc_expiry_date
string

It displays the date until which the registration of the vehicle is valid.

Example:

"23/12/2036"

​
vehicle_tax_upto
string

It displays the date until which the tax paid by the owner for the vehicle is valid.

Example:

""

​
vehicle_insurance_company_name
string

It displays the name of the insurance company associated with the vehicle.

Example:

"TATA AIG GENERAL INSURANCE CO. LTD."

​
vehicle_insurance_upto
string

It displays the date until which the insurance paid by the owner for the vehicle is valid.

Example:

"14/12/2024"

​
vehicle_insurance_policy_number
string

It displays the insurance policy number of the vehicle.

Example:

"62000344820000"

​
rc_financer
string

It displays the name of the financial institution or lender that provided financing for the purchase of a vehicle.

Example:

"BANDHAN BANK"

​
present_address
string

It displays the current address of the owner of the vehicle.

Example:

"FLAT # 901 A BLOCK GOYAL ORCHID, LAKE VIEW APTS KARIAGRAHARA, BELLANDUR, Bangalore, Karnataka, 560103"

​
split_present_address
object

It containts the address information in individual components.

Example:
{
  "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"
  }
}
​
permanent_address
string

It displays the permanent address of the owner of the vehicle.

Example:

"FLAT # 901 A BLOCK GOYAL ORCHID, LAKE VIEW APTS KARIAGRAHARA, BELLANDUR, Bangalore, Karnataka, 560103"

​
split_permanent_address
object

It containts the address information in individual components.

Example:
{
  "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"
  }
}
​
vehicle_cubic_capacity
string

It displays the cubic capacity of the vehicle's engine.

Example:

"998"

​
gross_vehicle_weight
string

It displays the gross weight of the vehicle in kilograms.

Example:

"1490"

​
unladen_weight
string

It displays the weight of the vehicle without carrying any load in kiolgrams.

Example:

"1086"

​
vehicle_category
string

It displays the category of the vehicle.

Example:

"LMV"

​
rc_standard_cap
string
Example:

"0"

​
vehicle_cylinders_no
string

It displays the number of cylinders present in the vehicle.

Example:

"3"

​
vehicle_seat_capacity
string

It displays the number of seats in the vehicle.

Example:

"5"

​
vehicle_sleeper_capacity
string

It displays the number of beds available in the vehicle.

Example:

"0"

​
vehicle_standing_capacity
string

It displays the number of people that can stand in the vehicle.

Example:

"0"

​
wheelbase
string

It displays distance between the front and rear axles of a vehicle in mm.

Example:

"2580"

​
vehicle_number
string

It displays the registration number of the vehicle.

Example:

"KA01MW6127"

​
pucc_number
string

It displays the Pollution Under Control Certificate (PUCC) number associated with vehicle.

Example:

"Newv4"

​
pucc_upto
string

It displays till when the PUCC number is valid.

Example:

"23/12/2022"

​
blacklist_status
string

It displays whether the vehicle is blacklisted.

Example:

"NA"

​
blacklist_details
object

It displays the reasons for blacklisting the vehicle.

​
challan_details
object

It displays traffic tickets or citations issued by traffic police or authorities for various traffic violations.

​
permit_issue_date
string

It displays when the relevant authorities granted permission or authorisation for a specific type of permit associated with the vehicle.

Example:

""

​
permit_number
string

It displays the permit number of the vehicle.

Example:

""

​
permit_type
string

It displays the type of permit issued to the vehicle.

Example:

""

​
permit_valid_from
string

It displays the beginning date of the issuance of permit.

Example:

""

​
permit_valid_upto
string

It displays the end date of the permit.

Example:

""

​
non_use_status
string

It displays whether the vehicle owner or registrant declared that the vehicle is not in use for a certain period.

Example:

""

​
non_use_from
string

It displays the beginning date of the non use period.

Example:

""

​
non_use_to
string

It displays the end date of the non use period.

Example:

""

​
national_permit_number
string

It displays the permit issued to the vehicle to go outside the home state carrying goods.

Example:

""

​
national_permit_upto
string

It displays the end date of the permit issued to the vechicle to go outside the home state carrying goods.

Example:

""

​
national_permit_issued_by
string

It displays the national permit issuer's name.

Example:

""

​
is_commercial
boolean

It displays whether the vehicle is for commercial purpose.

Example:

false

​
noc_details
string

It displays the details of the no objection certificate.

Example:

""