Skip to content

KYC APIs

Verify identities and check tax compliance status using government-issued data. The KYC (Know Your Customer) APIs provide real-time verification of PAN numbers, DigiLocker documents, and Section 206AB compliance — essential for customer onboarding, vendor verification, and regulatory compliance.

Use cases

IndustryUse case
Banks & NBFCsVerify PAN during account opening, loan applications, and KYC compliance
FintechAutomate identity verification during user onboarding
InsuranceValidate PAN details for policy issuance and claims processing
E-commerceVerify seller/merchant PAN during marketplace onboarding
Tax & compliance firmsCheck 206AB status to apply correct TDS rates
Corporate HRVerify employee PAN during payroll setup

Available endpoints

EndpointMethodPathDescription
PAN VerificationPOST/vas-api/pan-validation-v1Validate a PAN and get holder name and status
Compliance Status (206AB)POST/vas-api/compliance-status-v1Check TDS compliance status under Section 206AB
DigiLocker InitPOST/vas-api/v1/digilocker-initGenerate authorization URL for DigiLocker access
DigiLocker FetchPOST/vas-api/v1/digilocker-fetch-statusRetrieve verified documents from DigiLocker

Authentication

All KYC endpoints require an OAuth2 Bearer token. You need to:

  1. Sign up for a developer account
  2. Get an access token using your client credentials
  3. Include the token in every request: Authorization: Bearer YOUR_ACCESS_TOKEN

Quick example

Verify a PAN number in one call:

bash
curl -X POST https://api.api4business.com/vas-api/pan-validation-v1 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pan": "ABCDE1234F"}'

Error handling

All KYC endpoints return errors in a consistent format. See KYC Error Codes for the complete list, or the Error Handling Guide for retry patterns.

json
{
  "errorCode": 400,
  "errorType": "proxy",
  "errorMessage": "Invalid PAN"
}

What's next

Released under the API4Business Terms of Service