RC Verification API
Send a registration number and get the vehicle’s RC details on their own: owner, vehicle, validity dates, insurance, finance and permit status.
The documentation opens in the VerifyAll dashboard after sign-in, for accounts with approved API access. New to the API? Start with the developer guide.
Overview
What the RC Verification API does
The RC Verification API takes an Indian registration number, such as MH05DS4747, and answers with the registration certificate (RC) details held on record for it: the registered owner and owner serial number, the make, model, class, fuel type, engine and chassis numbers, where and when the vehicle was registered, and its registration status.
The answer also carries fitness, road tax, insurance and pollution certificate validity dates, the insurer and policy number, whether the vehicle is hypothecated and to which financer, national and state permits, and blacklist and NOC flags. No challans are looked up, so you pay for the RC record only.
It is a call of its own, POST /universal/rc-verification, billed as RC Verification. When you also need the challans in the same answer, the RC + Challan Verification API returns both; the Vehicle Challan Verification API returns the challans alone. The RC fields are the same in RC Verification and RC + Challan Verification, so the same code reads either answer.
How it works
- 1
Your server sends POST /universal/rc-verification with the registration_number, written without spaces, and an optional client_ref.
- 2
The request is checked first: a registration number in the wrong format is refused with a 400 and the list of problems, before anything runs or is charged.
- 3
The vehicle is checked against live records and the answer comes back in the same call, usually within about 5 seconds, in VerifyAll’s standard JSON envelope. If the first record source is unavailable, a second one is asked automatically, and you are billed once.
- 4
The result is stored in your VerifyAll account with a checkResultId, so you can read it again with GET /check-results/{id}, find it by your client_ref and download the RC Verification PDF report.
Request and response
RC Verification API endpoints and fields
The main fields; the full reference with every field, error code and a cURL sample is in the dashboard docs.
| Endpoint | What it does |
|---|---|
| POST/universal/rc-verification | Verify a vehicle’s RC details by registration number, without challans |
Request fields
| Field | What it is |
|---|---|
| registration_numberRequired | The vehicle registration number without spaces, for example MH05DS4747. |
| client_refOptional | Your own reference, stored with the result (up to 100 characters). The X-Client-Ref header does the same. |
What the answer returns
| Field | What it is |
|---|---|
| registration_number / status | The number checked and the registration status in lower case, for example active. |
| owner | Registered owner: name, father’s or husband’s name, owner serial number (1 for the first owner), present and permanent address, masked mobile. |
| vehicle | Maker, model, variant, class, category, body and fuel type, colour, engine and chassis numbers, month of manufacture, capacities, weights and emission norms. |
| registration | Date of registration, the registering office and the state. |
| validity | fitness_until, tax_paid_until, tax_lifetime, insurance_until and puc_until. |
| insurance / puc_number | Insurer and policy number, and the pollution under control certificate number. |
| financer / is_financed | Whether the vehicle is hypothecated and the financer named on the RC. |
| is_blacklisted / has_noc | Blacklist flag and whether a no-objection certificate is recorded; null when the record does not say. |
| permit | National and state permit numbers, permit type and validity dates, when the vehicle has one. |
Base URL https://api.verifyall.ai. Authenticate with the X-API-Key header (a va_sandbox_ or va_live_ key). Every answer carries data, status_code, success, message and message_code; checks add outcome, checkResultId, charged and charged_amount.
Key features
RC Verification API features and capabilities
The RC record only
No challan lookup runs or is billed, which suits checks where you need the owner, validity and finance details and handle fines separately or not at all.
The same fields as RC + Challan
The RC part of the answer has the same fields as the RC + Challan Verification API, so you can switch between them without changing your code.
Validity dates ready to compare
Fitness, tax, insurance, pollution certificate and permit dates come as YYYY-MM-DD, so expiry rules are a simple date comparison in your code.
Finance and blacklist flags
is_financed, financer, is_blacklisted and has_noc tell you at once whether a vehicle is under a loan or flagged before you accept it.
Use cases
Where businesses use the RC Verification API
Vehicle loans and refinance
Confirm the owner and the hypothecation status before you lend against a vehicle, and see whether another financer is already named.
Motor insurance
Read the vehicle class, fuel type, engine and chassis numbers and the current insurance validity at proposal or renewal.
Fleet and driver onboarding
Check the owner, permit, fitness and insurance validity of a vehicle joining your platform; add challans with the RC + Challan Verification API where fines matter.
Gates, yards and parking
Confirm that a vehicle is registered, active and insured when it arrives, without paying for its challan history each time.
Industries
Coverage
Vehicles registered in India, looked up by their registration number.
Limitations to plan for
- The answer holds what is on record for the vehicle. Fields the record does not hold come back as null, never guessed.
- A registration number with no record answers record_not_found. The lookup ran, so it is charged like any completed check.
- If the RC records cannot be read just now from any source, the call answers 424 and is not charged; try again later.
- No challans come back. Use the RC + Challan Verification API or the Vehicle Challan Verification API for them.
- The owner’s mobile number comes back masked; the full number is not returned.
Integration
How to integrate the RC Verification API
From a business account to your first live call.
Step 1
Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.
Step 2
Request Developer API access under Developers in the dashboard: the APIs you need, your expected monthly volume and your use case. The VerifyAll team reviews it and shares the API Services Agreement.
Step 3
Once the agreement is signed and access is approved, create your Sandbox key and build against sample data. Sandbox calls are never charged.
Step 4
Create your Production key, recharge your wallet and switch the key in your code: the endpoint and fields stay the same.
Get started
Request access to the RC Verification API
Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.
View API documentation
The full reference for RC Verification API (endpoints, fields, errors, cURL) opens in the dashboard once your access is approved.
Open the docs (sign-in)Create a business account
API keys are issued to an approved business account. Sign up, then request access under Developers.
Create account
Pricing
Production calls are charged per check from your prepaid VerifyAll wallet, at your account’s API price; GST is added separately when you recharge. Sandbox calls are never charged. Your API prices are shown in the dashboard once access is approved. How pricing works
Already have a business account? Sign in to request access
RC Verification API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
RC + Challan Verification API
LiveInstant answerSend a registration number and get the RC details, validity dates, finance and permit status and the vehicle’s challans in one answer.
View API detailsVehicle Challan Verification API
LiveInstant answerFind the traffic fines still open on a vehicle before you onboard, buy or finance it: the pending count, the unpaid total and every challan’s offences, fine and court status.
View API detailsFull Vehicle Legal Verification API
LiveFinishes laterStart one check on a registration number and read back a risk-rated report: RC, challans, FIRs and court cases, blacklist and owner history.
View API detailsDriving Licence Verification API
LiveInstant answerCheck that a driving licence is real, current and covers the vehicles your driver will drive, in one call.
View API details
All vehicle verification APIsRun RC Verification in the dashboard, without codeBrowse the API Marketplace
Start with the RC Verification API
Request access, build against the Sandbox, then go live with your Production key.
