TIN Verification API
Check an 11-digit state VAT or CST TIN and get the dealer registrations under it, for older paperwork and due diligence.
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 TIN Verification API does
Before GST arrived in 2017, businesses selling goods in India registered for VAT with their state and for CST for inter-state sales, and each registration carried an 11-digit Taxpayer Identification Number (TIN). The TIN Verification API takes such a TIN and returns the dealer registrations under it: the dealer name, the owner’s name, the VAT registration status, the CST status, the dates of registration and cancellation, and the address.
These numbers still turn up. Older contracts, long-standing vendor records, legacy ledgers, tax assessments that are still open and some tenders refer to TINs, and a due-diligence review often needs to confirm that a TIN belonged to the business that quoted it. The answer gives you that in one call, with the registration details in a fixed JSON shape.
TIN verification covers the pre-GST VAT and CST regime. For a business’s current indirect-tax status, verify its GSTIN with the GST Verification API; many teams call both when they reconcile old and new records for the same supplier.
How it works
- 1
Your server sends POST /universal/tin-fetch with the tin and, if you like, a client_ref. No consent object is needed.
- 2
The request is checked first: a TIN that is not exactly 11 digits is refused with 400 invalid_request, before anything runs or is charged.
- 3
The TIN is checked against live records and the dealer registrations come back in the same call, usually within about 3 seconds.
- 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 TIN verification PDF report.
Request and response
TIN 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/universal/tin-fetch | Return the dealer registrations of a state VAT / CST TIN |
Request fields
| Field | What it is |
|---|---|
| tinRequired | The state VAT / CST Taxpayer Identification Number, 11 digits. |
| client_refOptional | Your own reference, stored with the result (up to 100 characters). |
What the answer returns
| Field | What it is |
|---|---|
| tin | The TIN that was checked. |
| registrations[].dealer_name | The name of the registered dealer. |
| registrations[].owner_name | The owner’s name, where on record. |
| registrations[].registration_status | VAT registration status as recorded, for example ACTIVE or CANCELLED. |
| registrations[].cst_status | CST registration status as recorded. |
| registrations[].registered_on / cancelled_on | Dates of registration and cancellation, YYYY-MM-DD. |
| registrations[].address | The dealer’s address in parts and on one line. |
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
TIN Verification API features and capabilities
VAT and CST together
Each registration shows both the VAT status and the CST status, the two pre-GST registrations a goods dealer could hold.
Every registration under the TIN
registrations is a list, so a TIN with more than one dealer registration returns them all.
Dates for a timeline
Registration and cancellation dates show when the dealer was registered, useful for matching old invoices to a period.
Same envelope as every check
Outcome, checkResultId and charged amount in the standard JSON envelope, stored with a PDF report.
Use cases
Where businesses use the TIN Verification API
Legacy vendor records
Confirm the TIN held against an old supplier record before you archive or migrate it.
Pre-GST contract due diligence
Check the TIN quoted in an older contract or agreement belongs to the named dealer.
Ledger reconciliation
Match TINs on pre-2017 invoices to dealer names during audits and reconciliations.
Acquisition reviews
Confirm the historic VAT and CST registrations of a business you are acquiring or lending to.
Industries
Coverage
Eleven-digit state VAT and CST TINs issued in India before GST. It does not cover GSTINs; use the GST Verification API for those.
Limitations to plan for
- It covers the pre-GST VAT and CST regime. A registration status here is not the business’s current tax status.
- Owner names and addresses may be missing for older registrations; missing fields come back as null.
- A TIN with no record answers record_not_found. The lookup ran, so it is charged.
Integration
How to integrate the TIN 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 TIN 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 TIN 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
TIN Verification API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
GST Verification API
LiveInstant answerSend a GSTIN and get the business behind it: names, status, place of business and the returns it has filed, in one call.
View API detailsTAN Verification API
LiveInstant answerConfirm a TAN and the deductor it belongs to, or go one step further and get the company behind it.
View API detailsCIN 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 details
All business verification (KYB) APIsRun TIN verification in the dashboard, without codeBrowse the API Marketplace
Start with the TIN Verification API
Request access, build against the Sandbox, then go live with your Production key.