PAN to CIN API
Turn a company’s or LLP’s PAN into its CIN, and get the company’s details in the same answer.
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 PAN to CIN API does
Supplier forms, invoices and bank records usually carry a PAN, not a CIN. The PAN to CIN API takes the PAN of a company or a limited liability partnership and finds the CIN (or LLPIN) registered with it, together with the registered name and the type of company.
In the same call it returns the full company details for that CIN: status and is_active, class and category, listing, authorised and paid-up capital, incorporation date, registered address and the last AGM and balance sheet dates. That is the same company object the CIN Verification API returns, so one lookup takes you from a PAN on a form to a complete company profile.
Only company and LLP PANs have a CIN. The fourth letter of a PAN says what kind of holder it belongs to, and this API takes only those whose fourth letter is C (company) or F (firm or LLP). Any other PAN, such as an individual’s, is refused before the check runs, so you are never charged for a lookup that could not find anything.
How it works
- 1
Your server sends POST /universal/pan-to-cin with the pan and, if you like, a client_ref. A check about a company takes no consent object.
- 2
The request is checked first: a malformed PAN, or a PAN whose fourth letter is not C or F, is refused with 400 invalid_request before anything runs or is charged.
- 3
The PAN is checked against live records, the CIN or LLPIN is found and the company’s details are added, usually within about 6 seconds, in the same call.
- 4
The result is stored in your VerifyAll account with a checkResultId, so you can read it again and find it by your client_ref.
Request and response
PAN to CIN 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/universal/pan-to-cin | Find the CIN or LLPIN of a company or LLP PAN, with its company details |
Request fields
| Field | What it is |
|---|---|
| panRequired | The PAN of the company or LLP, 10 characters, with C or F as the fourth letter (for example AAACA0000A). |
| client_refOptional | Your own reference, stored with the result (up to 100 characters). |
What the answer returns
| Field | What it is |
|---|---|
| pan | The PAN that was checked. |
| cin | The CIN, or LLPIN for an LLP, registered with the PAN. |
| company_name | The registered name of the company or LLP. |
| company_type | For example Private limited company, Public limited company, Limited liability partnership. |
| details_available | True when the full company details were found. False: only the CIN, name and type are known, and the check is still charged. |
| company | The company details in the same fields as the CIN Verification API: status, is_active, class, capital, incorporated_on, registered_address, last_agm_on and the rest; null when details_available is false. |
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
PAN to CIN API features and capabilities
Two lookups in one call
PAN to CIN and the company’s details come back together, so you do not need a second request to the CIN Verification API.
Refuses PANs that cannot match
Only C and F PANs are accepted. An individual’s or a trust’s PAN is refused up front and never charged.
Companies and LLPs
Works for both: an LLP’s PAN returns its LLPIN in the cin field.
Also in bulk
The Bulk Verification API runs PAN to CIN on 5 to 10,000 PANs a batch for a whole vendor master.
Use cases
Where businesses use the PAN to CIN API
Vendor master clean-up
Add the CIN and company status to every supplier record that holds only a PAN.
Invoice-led supplier onboarding
Start from the PAN on a supplier’s invoice and land on its full company profile in one step.
Corporate borrower KYB
Find a borrower’s CIN from the PAN in its loan application and check that the company is active.
Linking records across systems
Join finance records keyed by PAN with legal and compliance records keyed by CIN.
Industries
Coverage
PANs of companies and LLPs incorporated in India (fourth letter C or F). Proprietorships, partnerships without LLP status and individuals have no CIN and are not covered.
Limitations to plan for
- Only PANs with C or F as the fourth letter are accepted; any other PAN is refused before charge.
- When the CIN is found but the company details cannot be added, details_available is false and the check is still charged: the lookup ran.
- A C or F PAN with no CIN or LLPIN registered with it answers record_not_found. The lookup ran, so it is charged.
- The answer does not list directors or filed documents; use the Company Directors API and the MCA Documents API for those.
Integration
How to integrate the PAN to CIN 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 PAN to CIN 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 PAN to CIN 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
PAN to CIN API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
CIN Verification API
LiveInstant answerSend a Corporate Identification Number and get the company’s name, status, capital, address and compliance dates back in one call.
View API detailsCompany Directors API
LiveInstant answerSend a CIN and get every director and authorised signatory of the company, with DIN, designation and appointment date.
View API detailsBulk Verification API
LiveBulk batchSend a whole list of PANs or GSTINs in one request and read back each row’s result, in the same shape as the single check.
View API detailsPAN to Udyam API
LiveInstant answerSend a PAN and find out whether the business is MSME-registered, with its Udyam number, class and certificate.
View API details
All business verification (KYB) APIsRun PAN to CIN in the dashboard, without codeBrowse the API Marketplace
Start with the PAN to CIN API
Request access, build against the Sandbox, then go live with your Production key.