Compliance Status (206AB)
Check whether a PAN holder falls under Section 206AB of the Income Tax Act, which mandates higher TDS rates for non-filers.
Endpoint
POST /vas-api/compliance-status-v1
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/compliance-status-v1 \
-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/compliance-status-v1",
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/compliance-status-v1",
{
method: "POST",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({ pan: "ABCDE1234F" })
}
);
console.log(await response.json());java
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.api4business.com/vas-api/compliance-status-v1"))
.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 | integer | HTTP status code |
| message | string | Status message |
| body.pan | string | The PAN that was checked |
| body.panName | string | Masked name on PAN |
| body.panStatus | string | PAN operative status (Operative, Inoperative) |
| body.finYear | string | Financial year of the check |
| body.applicableFlag | string | Y if 206AB applies (higher TDS), N if compliant |
| body.panAadhaarLinkStatus | string | PAN-Aadhaar link status (Linked, NA) |
| body.panAllotmentDateString | string | Date PAN was allotted |
Example response
json
{
"ok": true,
"responseCode": 200,
"message": "Transmission OK",
"body": {
"srNo": 4620,
"pan": "ABCDE1234F",
"panName": "SXXXXX EXXXXXXXXE PXXXXXE LXXXXXD",
"finYear": "2024-25",
"panAadhaarLinkStatus": "NA",
"panStatus": "Operative",
"applicableFlag": "N",
"panAllotmentDateString": "22-05-2017",
"panAllotmentDate": null,
"lastSynced": null
}
}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 format (AAAAA9999A) |
| 400 | 400 | Invalid Request | Verify request body format |
| 401 | 401 | Invalid Credentials | Refresh your access token |
| 429 | 429 | Quota Violation | Rate limit exceeded — retry with backoff |
| 500 | 500 | Internal Server Error | Retry after delay |
| 503 | 503 | Service Not Available | Upstream unavailable — retry |