RC + Challan Verification API
Send a registration number and get the RC details, validity dates, finance and permit status and the vehicle’s challans in one answer.
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 + Challan Verification API does
The RC + Challan 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 same answer carries what a lender, insurer or fleet operator usually checks next: 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, blacklist and NOC flags, and the traffic challans recorded against the vehicle with the pending count and the unpaid amount. If the challans cannot be retrieved at that moment, the RC details still come back, with challans.available set to false, so one slow part never blocks the rest.
Use it when a vehicle or a driver joins your platform, before you lend against a vehicle, before you insure or renew a policy, and before a used vehicle is listed or bought. Every field comes back in the same fixed JSON shape, so your code reads one structure whatever the vehicle. Need only one of the two? The RC Verification API returns the RC details alone, and the Vehicle Challan Verification API the challans alone.
How it works
- 1
Your server sends POST /universal/vehicle-detailed-advanced 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.
- 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 + Challan Verification PDF report.
Request and response
RC + Challan 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/vehicle-detailed-advanced | Verify a vehicle’s RC details and challans by registration number |
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. |
| challans | available, count, pending_count, total_pending_amount and items: challan number, date, place, offences, fine, status (pending, paid, disposed) and whether it went to court. |
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 + Challan Verification API features and capabilities
RC and challans in one call
Registration details and the challans recorded against the vehicle arrive together, so you do not chain two requests or merge two answers.
RC still answers when challans are slow
If the challans cannot be retrieved, the rest of the result is complete and challans.available is false, so you can approve on the RC and look at challans again later.
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 + Challan Verification API
Fleet and driver onboarding
Check the vehicle a driver or transporter brings to your platform: owner, permit, fitness and insurance validity, and unpaid challans.
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.
Used-vehicle marketplaces
Show buyers the owner serial number, registration status and pending challans before a listing goes live or a sale closes.
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.
- Challans can occasionally be unavailable for a vehicle at the moment of the call; the RC details still return and challans.available is false.
- The owner’s mobile number comes back masked and accused names on challans are masked; full values are not returned.
Integration
How to integrate the RC + Challan 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 + Challan 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 + Challan 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 + Challan Verification API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
RC Verification API
LiveInstant answerSend a registration number and get the vehicle’s RC details on their own: owner, vehicle, validity dates, insurance, finance and permit status.
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 + Challan Verification in the dashboard, without codeBrowse the API Marketplace
Start with the RC + Challan Verification API
Request access, build against the Sandbox, then go live with your Production key.
