POSTVehicle & RC Verification

Verify a vehicle's registration certificate (RC) in real time — owner details, chassis/engine numbers, insurance validity, blacklist status, permits, fitness, and financier info via the VAHAN national database.

POST/tools/kyc/vehicle-rc

Send a vehicle registration number and receive a comprehensive RC dataset in a single API call. The response covers ownership (name, father's name, address), registration details (authority, dates, expiry), insurance (company, policy number, validity), compliance (blacklist, challan, PUCC, emission norms), commercial-vehicle specifics (permit type/validity, fitness certificate, national permit, tax status), and financier information. Pan-India coverage via the VAHAN database makes it suitable for driver onboarding, fleet monitoring, motor insurance underwriting, vehicle finance, and used-car platforms.

Body parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200
`client_ref_id`	string	optional	Unique reference id per API call, generated by your system.e.g. REQ-20260101-001
`vehicle_number`	string	required	Vehicle registration number to verify (e.g. HR26DA8398).e.g. HR26DA8398

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

client_ref_idstringoptional

Unique reference id per API call, generated by your system.

example: REQ-20260101-001

vehicle_numberstringRequired

Vehicle registration number to verify (e.g. HR26DA8398).

example: HR26DA8398

Headers

Field	Type	Required	Description
`developer_key`	string	required	Static API key issued to your account after KYC.
`secret-key`	string	required	Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).
`secret-key-timestamp`	string	required	Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.
`content-type`	string	required	application/jsone.g. application/json

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- reference_idstring
  Unique reference ID for this verification request returned by Eko.
- statusstring
  Verification status string (e.g. 'Active', 'Inactive').
- reg_nostring
  Vehicle registration number as recorded in the VAHAN database.
- rc_statusstring
  Current RC status — 'Active', 'Inactive', 'Suspended', etc.
- status_as_onstring
  Date on which the RC status was last updated.
- ownerstring
  Full name of the registered owner of the vehicle.
- owner_father_namestring
  Father's name of the registered owner.
- owner_countnumber
  Number of previous owners, including the current one.
- mobile_numberstring
  Mobile number of the owner as registered with the RTO, if available.
- present_addressstring
  Present address of the owner as a single string.
- split_present_addressobject
  Present address broken into structured components.
  - house_flat_numberstring
    House/flat number.
  - streetstring
    Street or locality.
  - citystring
    City name.
  - statestring
    State name.
  - pincodestring
    PIN code.
- permanent_addressstring
  Permanent address of the owner as a single string.
- split_permanent_addressobject
  Permanent address broken into structured components.
  - house_flat_numberstring
    House/flat number.
  - streetstring
    Street or locality.
  - citystring
    City name.
  - statestring
    State name.
  - pincodestring
    PIN code.
- reg_authoritystring
  Regional Transport Office (RTO) that issued the RC.
- reg_datestring
  Date of first registration of the vehicle (YYYY-MM-DD).
- rc_expiry_datestring
  RC validity expiry date (YYYY-MM-DD). Private vehicles are typically 15 years from registration.
- classstring
  Vehicle class as registered with the RTO (e.g. 'Motor Car', 'LMV', 'HTV').
- vehicle_categorystring
  High-level vehicle category (e.g. 'LMV', 'HMV', 'M-Cycle').
- typestring
  Ownership type — 'Private' or 'Commercial'.
- is_commercialboolean
  True if the vehicle is registered for commercial use.
- vehicle_manufacturer_namestring
  Manufacturer / make of the vehicle.
- modelstring
  Vehicle model name.
- body_typestring
  Body type of the vehicle (e.g. 'Hard Top', 'Open Body', 'Tipper').
- vehicle_colorstring
  Color of the vehicle as registered.
- fuel_typestring
  Fuel type — 'Petrol', 'Diesel', 'CNG', 'Electric', etc.
- norms_typestring
  Emission standard the vehicle complies with (e.g. 'Bharat Stage VI').
- emission_normsstring
  Human-readable emission norms label returned in some responses.
- chassisstring
  Chassis number of the vehicle as per RC.
- enginestring
  Engine number of the vehicle as per RC.
- vehicle_manufacturing_month_yearstring
  Month and year of vehicle manufacture.
- vehicle_cubic_capacitystring
  Engine cubic capacity in cc.
- vehicle_cylinders_nostring
  Number of cylinders in the engine.
- vehicle_seat_capacitystring
  Seating capacity of the vehicle.
- vehicle_sleeper_capacitystring
  Sleeper capacity (relevant for transport/bus vehicles).
- vehicle_standing_capacitystring
  Standing capacity (relevant for buses).
- gross_vehicle_weightstring
  Gross vehicle weight in kg.
- unladen_weightstring
  Unladen (kerb) weight of the vehicle in kg.
- wheelbasestring
  Wheelbase of the vehicle in mm.
- vehicle_insurance_company_namestring
  Name of the insurance company that issued the current motor policy.
- vehicle_insurance_policy_numberstring
  Insurance policy number.
- vehicle_insurance_uptostring
  Insurance validity date (YYYY-MM-DD). Check against today to flag lapsed policies.
- rc_financerstring
  Name of the financier / lending institution if the vehicle is under a loan.
- vehicle_tax_uptostring
  Road tax validity date.
- pucc_numberstring
  Pollution Under Control Certificate (PUCC) number.
- pucc_uptostring
  PUCC validity date.
- blacklist_statusstring
  Whether the vehicle appears on a blacklist — 'Not Blacklisted' or 'Blacklisted'.
- blacklist_detailsobject
  Detailed blacklist information; populated only if the vehicle is blacklisted.
  - reasonstring
    Reason for blacklisting.
  - authoritystring
    Authority that issued the blacklist order.
- challan_detailsobject
  Pending traffic challan information, if any.
  - challan_nostring
    Challan number.
  - amountstring
    Challan amount in INR.
  - statusstring
    Challan payment status.
- noc_detailsstring
  No Objection Certificate details, if applicable.
- non_use_statusstring
  Indicates if the vehicle has been declared 'non-use'.
- non_use_fromstring
  Start date of the non-use period, if applicable.
- non_use_tostring
  End date of the non-use period, if applicable.
- permit_numberstring
  State permit number (commercial vehicles only).
- permit_typestring
  Type of permit — e.g. 'Tourist', 'Contract Carriage', 'Goods'.
- permit_issue_datestring
  Date on which the permit was issued.
- permit_valid_fromstring
  Permit validity start date.
- permit_valid_uptostring
  Permit validity end date.
- national_permit_numberstring
  National permit number for goods/transport vehicles operating across states.
- national_permit_uptostring
  National permit validity date.
- national_permit_issued_bystring
  State authority that issued the national permit.