Full Vehicle Legal Verification API

The Full Vehicle Legal Verification API is the deepest vehicle check VerifyAll offers. From one registration number it builds a single report: the RC details in the same fields as the RC verification, the challans recorded against the vehicle with paid and pending totals, the police FIRs and court cases that name the vehicle, stolen or seized vehicle matches, blacklist and NOC status, the applications recorded for the vehicle and the list of its owners from first to current.

The report opens with a risk rating, low, medium or high (or unknown while no rating is possible), drawn from the challans, the court records and the registration status. A modules list adds one plain sentence per part of the check, so a reviewer or your own rules can see at a glance which part found something.

The check runs in the background. The create call returns a record id straight away and you read the report once its status is completed. Use it where the downside of a vehicle is large: lending against a vehicle, a high-value used purchase, a certified pre-owned programme or underwriting a commercial fleet.

How it works

1. 1

   Your server sends POST /full-vehicle-background-check/create with the registration_number and an optional client_ref. The answer carries data.id and outcome pending.

2. 2

   The check is charged once, at creation, from your prepaid wallet. If it cannot be started, the charge is refunded.

3. 3

   The check runs in the background and finishes later. Poll GET /full-vehicle-background-check/list/{id} a few minutes apart, or add a webhook endpoint and receive check.completed (or check.failed) when it ends.

4. 4

   Read the report from GET /full-vehicle-background-check/list/{id} once status is completed, and download the vehicle legal PDF report for the record.