Comprehensive Business Verification API
The basic KYB report plus the business’s filed MCA documents and its commercial credit report, started with one request.
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 Comprehensive Business Verification API does
The Comprehensive Business Verification API is the deeper of VerifyAll’s two business reports. It runs every module of the Basic Business Verification API and adds two: the company’s filed MCA documents, for a company with a CIN, and the business’s commercial credit report. Both come back inside the same record, in the data schema of their stand-alone APIs.
The extra modules answer questions the basic report cannot. Filed MCA documents hold the financial statements, annual returns and charges behind a company’s profile, so an analyst can read the balance sheet and see who has lent against its assets. The commercial credit report shows how the business borrows and repays: its facilities, outstanding and overdue amounts and any defaults on record.
That makes it the report for decisions where money or a long contract is at stake: a business loan or working-capital limit, a large supplier or distributor onboarded on credit terms, or diligence before an acquisition or investment. The credit report is found by the business’s name and PAN and needs the business’s agreement, so this report always takes a pan and a consent object; there is no without-PAN form. For routine vendor or merchant checks, the basic report is lighter.
How it works
- 1
Your server sends POST /full-business-bgv/create-comprehensive with company_name, company_type, address, pan and consent (the business’s agreement to its commercial credit report being pulled), plus cin for a private or public limited company and any optional details.
- 2
The request is checked first: a missing field, a malformed identifier or a missing consent 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
The modules run in the background. Read GET /full-business-bgv/list/{id}, where report_level is comprehensive, until status is completed: it moves from processing to partially_completed (court records still running) to completed, or failed.
- 4
The record carries each module’s status, summary and result, the progress and the overall verdict, and is downloadable as a PDF report. A module that cannot be completed is refunded to your wallet.
Request and response
Comprehensive business 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/full-business-bgv/create-comprehensive | Start a comprehensive business verification report |
| GET/full-business-bgv/list/{id} | Read a report with its modules, report_level and overall result |
| GET/full-business-bgv/list | List your business reports, basic and comprehensive, with their progress |
Request fields
| Field | What it is |
|---|---|
| company_nameRequired | The registered name of the business, 2 to 200 characters. |
| company_typeRequired | private_limited, public_limited, llp, proprietorship, registered_partnership, unregistered_partnership or foreign_llc (other is refused). It decides which checks apply. |
| addressRequired | The registered address on one line, 5 to 300 characters. |
| panRequired | The business’s PAN. Required: the commercial credit report is found by the business’s name and PAN. |
| consentRequired | The business’s agreement to its credit report being pulled: obtained (true), purpose, obtained_at, method (web_form, paper, voice, sms or other) and text_version. Kept with the report. |
| cinOptional | Required for, and only used for, private_limited and public_limited. The filed MCA documents module needs it. |
| gstin / udyam_numberOptional | The business’s GSTIN and Udyam registration number, if you have them. |
| city / district / stateOptional | Parts of the address that help the court records module confirm cases. |
| past_addresses / former_namesOptional | Up to 10 earlier addresses and up to 10 former or brand names, searched in court records too. |
| client_refOptional | Your own reference, stored with the report (up to 100 characters). |
What the answer returns
| Field | What it is |
|---|---|
| id / status | The report id; pending on creation, then processing, partially_completed, completed or failed. |
| report_level | comprehensive for this report (basic for the Basic Business Verification API). |
| overall | clear, review, incomplete or pending, over every module. |
| business | The business as sent: name, company_type, pan, cin, gstin, udyam_number and address. |
| progress | Modules in total, completed, failed and pending. |
| modules[].name | The basic modules (pan, business_records, directors, gstin, udyam, udyam_by_pan, adverse_media, court_records) plus mca_documents and commercial_credit. |
| modules[].status / summary | Each module’s state (processing, completed, no_record, failed, invalid_input) and one plain sentence on its outcome. |
| modules[].result | The module’s result in the schema of its stand-alone API: for mca_documents, the documents of an MCA documents order; for commercial_credit, the commercial credit report. |
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
Comprehensive Business Verification API features and capabilities
Everything in the basic report
Every basic module still runs, so you never call both reports.
Filed MCA documents included
For a company with a CIN, its filings are listed with download paths, as in the MCA Company Documents API.
Commercial credit in the same record
Credit facilities, repayment behaviour and defaults sit beside registrations and litigation, under one verdict.
Consent kept with the report
The consent you send, with when and how it was captured, is stored with the report for your audit trail.
Use cases
Where businesses use the Comprehensive Business Verification API
Business lending and credit limits
Give an underwriter the borrower’s credit history, filed financial statements and litigation in one file.
Large vendor and distributor onboarding
Check the financial standing of a strategic supplier, or a distributor you sell to on credit, before a large contract.
M&A and investment diligence
Start diligence on a target company with its filings, borrowings, directors and court cases gathered in one report.
Periodic reviews of key counterparties
Re-run the report on major customers or suppliers each year and compare them over time.
Industries
Coverage
Businesses in India with a PAN: private and public limited companies, LLPs, partnerships, proprietorships and foreign LLCs. Filed MCA documents are added for companies with a CIN.
Limitations to plan for
- A PAN and the business’s consent are always required; a business with only a GSTIN can use the Basic Business Verification API instead.
- The report finishes later, not in the same call; court records and the document order can stay open after the other modules are done.
- The filed MCA documents module runs only for companies with a CIN, so it does not apply to proprietorships and partnerships.
- Records are read with the Production key; Sandbox results are read back through GET /check-results.
Integration
How to integrate the Comprehensive Business 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 Comprehensive Business 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 Comprehensive Business 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
Comprehensive Business Verification API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
Basic Business Verification API
LiveFinishes laterOne request runs the business checks a KYB review needs and returns one report with an overall result.
View API detailsCommercial Credit Report API
LiveInstant answerSee a business’s credit facilities, overdues and defaults from its name and PAN before you lend to it or sell to it on credit.
View API detailsMCA Company Documents API
LiveFinishes laterOrder every document a company or LLP has filed, by CIN or LLPIN, and download the files when the order completes.
View API detailsCourt Records Verification API
LiveFinishes laterFind the civil and criminal court cases of a person or a business, with each case’s court, status and next hearing, in one asynchronous API.
View API details
All business verification (KYB) APIsRun Comprehensive business verification in the dashboard, without codeBrowse the API Marketplace
Start with the Comprehensive Business Verification API
Request access, build against the Sandbox, then go live with your Production key.