Skip to main content
VerifyAll logo
LiveInstant answerSandbox

CIN Verification API

Send a Corporate Identification Number and get the company’s name, status, capital, address and compliance dates back in one call.

Request API access Book a demo View API documentation

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 CIN Verification API does

The CIN Verification API takes a 21-character Corporate Identification Number and answers with the company’s details as held on record: its registered name, its status (Active, Strike Off, Amalgamated and so on) with an is_active flag, its class, category and sub-category, whether it is listed, its authorised and paid-up capital, the number of members, the date of incorporation, the registered office address, the email on record and the dates of its last annual general meeting and last balance sheet.

Those fields answer the questions a KYB review asks first. Is the company real and still active? Is it private or public, and listed or not? How much capital is paid up? Has it held an AGM and filed a balance sheet recently, or has it gone quiet? Your onboarding rules can read is_active, paid_up_capital and last_balance_sheet_on directly instead of a person reading a screen.

Lenders, procurement teams, payment companies and B2B marketplaces call it when a company is onboarded as a customer, borrower, supplier or partner, and again before a contract renewal. When you only have the company’s PAN, start with the PAN to CIN API, which returns the same company details.

How it works

  1. 1

    Your server sends POST /universal/company-master-data with the cin and, if you like, a client_ref. A check about a company takes no consent object.

  2. 2

    The request is checked first: a CIN that does not match the 21-character format is refused with 400 invalid_request, before anything runs or is charged.

  3. 3

    The CIN is checked against live records and the company’s details come back in the same call, usually within about 3 seconds.

  4. 4

    The result is stored in your VerifyAll account with a checkResultId, so you can read it again, find it by your client_ref and download the company verification PDF report.

Request and response

CIN 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.

Endpoints
EndpointWhat it does
POST/universal/company-master-dataVerify a company by CIN and return its details

Request fields

CIN Verification API request fields
FieldWhat it is
cinRequiredThe Corporate Identification Number, 21 characters (for example U12345MH2015PTC123456).
client_refOptionalYour own reference, stored with the result (up to 100 characters).

What the answer returns

CIN Verification API answer fields
FieldWhat it is
cin / nameThe CIN and the company’s registered name.
status / is_activeCompany status as recorded (Active, Strike Off, Amalgamated ...) and whether it is active, as true or false.
class / category / sub_categoryPrivate or Public; for example Company limited by shares; for example Non-government company.
is_listed / suspended_at_stock_exchangeWhether the company is listed on a stock exchange, and whether it is suspended there.
authorised_capital / paid_up_capitalCapital in rupees, as strings with two decimals.
number_of_membersNumber of members, where the record holds it.
incorporated_onDate of incorporation, YYYY-MM-DD.
registered_address / other_addressThe registered office address in parts and on one line, and any other address on record.
emailThe company’s email address on record.
last_agm_on / last_balance_sheet_onDates of the last annual general meeting and the last balance sheet.
complianceThe company’s active-compliance status, as worded on record.
roc / registration_numberThe ROC jurisdiction the company is registered under, and its registration number.

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

CIN Verification API features and capabilities

  • Status as text and as a flag

    The status text is kept for your records and is_active gives a true or false, so struck-off and amalgamated companies can be stopped by a rule.

  • Capital in a parseable form

    Authorised and paid-up capital come back as rupee amounts with two decimals, ready for thresholds in a credit or vendor policy.

  • Compliance dates

    The last AGM and last balance sheet dates show whether a company is keeping up with its annual filings.

  • Same shape across the company APIs

    PAN to CIN, TAN to company details and MCA documents return the company in these same fields, so one parser serves them all.

Use cases

Where businesses use the CIN Verification API

  • Corporate customer onboarding

    Confirm a company exists and is active before you open an account, issue credit or sign an agreement with it.

  • Supplier due diligence

    Check a supplier’s status, capital and filing dates before it joins your approved vendor list.

  • Business lending

    Read paid-up capital, incorporation date and compliance status as early inputs to a credit decision.

  • Contract and invoice checks

    Match the registered name and address on a contract or invoice to the company’s details on record.

Industries

Coverage

Companies incorporated in India with a 21-character CIN, listed and unlisted, private and public.

Limitations to plan for

  • The request takes a CIN. If you have only the company’s PAN, call the PAN to CIN API instead.
  • Fields the record does not hold come back as null. Capital and AGM dates for a newly incorporated company may be empty.
  • A CIN with no record answers record_not_found. The lookup ran, so it is charged.
  • The answer covers the company itself. For its directors and signatories call the Company Directors API; for its filed documents, the MCA Documents API.

Integration

How to integrate the CIN Verification API

From a business account to your first live call.

  1. Step 1

    Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.

  2. 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.

  3. 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.

  4. 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 CIN Verification API

Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.

Tell us about your integration

Tell us what you want to verify and how many checks you expect. Our team replies within one business day with access steps, Sandbox details and your API pricing.

We use these details only to reply to your request. See our privacy policy.

  • Contact sales

    Questions on volumes, onboarding or the API agreement.

    Contact sales

  • View API documentation

    The full reference for CIN 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

CIN Verification API: frequently asked questions

Answers for teams planning an integration.

Still have questions? Our team is happy to help.

Contact Support

All business verification (KYB) APIsRun CIN verification in the dashboard, without codeBrowse the API Marketplace

Start with the CIN Verification API

Request access, build against the Sandbox, then go live with your Production key.

Request API access