Background Verification API

The Background Verification API runs several checks on one person from a single request. You choose the modules: PAN, GST registrations linked to the PAN, credit score, court records, adverse media (AML screening), employment (UAN employment history), driving licence, voter ID, passport and mobile number. They run in the background into one record with each module’s status, summary and result.

HR teams, staffing firms and platforms onboarding drivers and delivery partners use it to replace a chain of separate calls with one. overall is clear when every module ran and nothing adverse was found, review when court records or adverse media were found or the court result is unresolved, and incomplete when a module could not be completed.

For people without a PAN to hand, such as many gig workers, POST /full-verification/create/gig-worker runs the same checks except pan, gstin and credit_score. GET /full-verification/quote gives the charge of a selection first; send it back as quoted_total and a changed price is refused with 409 price_changed, not charged.

How it works

1. 1

   Optionally call GET /full-verification/quote with the package (with_pan or without_pan) and the modules to see what the create call will debit; nothing is charged.

2. 2

   Send POST /full-verification/create (or /create/gig-worker) with modules, name, surname, mobile, address, pan where the package needs it, the inputs each chosen module uses, quoted_total and the consent object. A module chosen without its input is refused with 400 before any charge.

3. 3

   The request is accepted at once with outcome pending and a data.id, and charged once from your prepaid wallet. Modules run in the background and finish later, from minutes to a few business days; a module that fails is refunded.

4. 4

   Poll GET /full-verification/list/{id} for status and progress, or receive check.completed by webhook, then read the report and download its PDF with POST /pdf-reports/full-bgv-individual.