Basic Business Verification API

The Business Verification (KYB) API runs a basic business verification report on a company, LLP, partnership or proprietorship from one request. You send the business’s name, legal form, address and PAN (or its GSTIN when it has no PAN), plus a CIN for private and public limited companies, and VerifyAll runs the checks those details allow: PAN verification, business records, GST verification, Udyam verification, PAN to Udyam, AML screening of the business and a court records search.

Each module’s result comes back in the same data schema as the stand-alone API for that check, inside one record with an overall verdict: clear when every module ran and nothing adverse was found, review when court records or adverse media turned up or a court result needs a human eye, incomplete when a module could not be completed. Your workflow can approve clear reports automatically and route the rest to a reviewer.

The report finishes later. The create call is charged once and returns a record id with status pending; you read the record back as the modules finish. Court records usually take longest, so the record shows partially_completed while everything else is done. A module that cannot be completed is refunded to your wallet.

How it works

1. 1

   Your server sends POST /full-business-bgv/create with company_name, company_type, address and pan (or gstin), plus cin for a private or public limited company and, if you have them, the udyam_number, city, district, state, past addresses and former names.

2. 2

   The request is checked first: a missing required field or a malformed identifier is refused with 400 invalid_request, listing the fields, before anything is charged. A valid request is charged once and answers with data.id and status pending.

3. 3

   The modules run in the background. Read GET /full-business-bgv/list/{id} until status is completed: it moves from processing to partially_completed (court records still running) to completed, or failed.

4. 4

   The record carries the business, each module’s name, status, summary and result, the module progress and the overall verdict, and is downloadable as the business verification PDF report.