Telr Developer Documentation

Get Vehicle RC Details

curl --request GET \
  --url https://sandbox.cashfree.com/verification/vehicle-rc \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'

import requests

url = "https://sandbox.cashfree.com/verification/vehicle-rc"

headers = {
    "x-client-id": "<api-key>",
    "x-client-secret": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-client-id': '<api-key>', 'x-client-secret': '<api-key>'}
};

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 => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.cashfree.com/verification/vehicle-rc"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-client-id", "<api-key>")
	req.Header.Add("x-client-secret", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://sandbox.cashfree.com/verification/vehicle-rc")
  .header("x-client-id", "<api-key>")
  .header("x-client-secret", "<api-key>")
  .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::Get.new(url)
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'

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
}

GET

vehicle-rc

Get Vehicle RC Details

curl --request GET \
  --url https://sandbox.cashfree.com/verification/vehicle-rc \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'

import requests

url = "https://sandbox.cashfree.com/verification/vehicle-rc"

headers = {
    "x-client-id": "<api-key>",
    "x-client-secret": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-client-id': '<api-key>', 'x-client-secret': '<api-key>'}
};

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 => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.cashfree.com/verification/vehicle-rc"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-client-id", "<api-key>")
	req.Header.Add("x-client-secret", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://sandbox.cashfree.com/verification/vehicle-rc")
  .header("x-client-id", "<api-key>")
  .header("x-client-secret", "<api-key>")
  .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::Get.new(url)
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'

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

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret

string

header

required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

x-cf-signature

string

Send the signature if IP is not whitelisted.

Query Parameters

reference_id

string

Unique ID generated by Cashfree to search for the identity.

verification_id

string

Unique ID generated by the merchant to identify the verification request.

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.

Show child attributes

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.

Show child attributes

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:

""