PAN to CIN
Find the Corporate Identification Number (CIN) linked to a PAN. Returns the company name, CIN, and entity name — useful for cross-referencing company identity.
Endpoint
POST /vas-api/v1/pan-to-cin
Authentication
Requires OAuth2 Bearer token. Get your credentials →
Request
Headers
| Header | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | Bearer YOUR_ACCESS_TOKEN |
| Content-Type | string | Yes | application/json |
Body parameters
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| pan | string | Yes | 10-character PAN number | ABCDE1234F |
Example request
bash
curl -X POST https://api.api4business.com/vas-api/v1/pan-to-cin \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"pan": "ABCDE1234F"}'python
import requests
response = requests.post(
"https://api.api4business.com/vas-api/v1/pan-to-cin",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
json={"pan": "ABCDE1234F"}
)
print(response.json())javascript
const response = await fetch(
"https://api.api4business.com/vas-api/v1/pan-to-cin",
{
method: "POST",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({ pan: "ABCDE1234F" })
}
);
console.log(await response.json());java
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.api4business.com/vas-api/v1/pan-to-cin"))
.header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\"pan\": \"ABCDE1234F\"}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());Response
Success (200)
| Field | Type | Description |
|---|---|---|
| ok | boolean | true if successful |
| responseCode | number | HTTP status code |
| message | string | Status message |
| body.pan | string | The PAN that was queried |
| body.cin | string | Corporate Identification Number linked to the PAN |
| body.entityName | string | Registered name of the company |
Example response
json
{
"ok": true,
"responseCode": 200,
"message": "Transmission OK",
"body": {
"pan": "ABCDE1234F",
"cin": "U72900MH2017PTC295173",
"entityName": "SAMPLE SOLUTIONS PRIVATE LIMITED"
}
}Response headers
| Header | Description |
|---|---|
| x-request-id | Unique request identifier — log this for debugging and support |
Error responses
| Status | Error Code | Message | Resolution |
|---|---|---|---|
| 400 | 400 | Invalid PAN | Check PAN is 10 characters (5 alpha + 4 digits + 1 alpha) |
| 400 | 400 | Invalid Request | Verify JSON body contains pan field |
| 401 | 401 | Invalid Credentials | Access token expired — request a new one |
| 429 | 429 | Quota Violation | Rate limit exceeded — retry with backoff |
| 500 | 500 | Internal Server Error | Retry after delay |
| 503 | 503 | Service Not Available | MCA service temporarily down — retry |
No CIN found?
If the PAN is not linked to a registered company, the response body may be empty or contain a specific message. This does not mean the PAN is invalid — it means no CIN is registered against it. Use PAN Verification to validate the PAN itself.
Related
- CIN Details — Get full company details from CIN
- PAN to MSME — Check MSME registration by PAN
- PAN Verification — Validate the PAN itself
- Company Verification Overview