post https://sandbox.cashfree.com/verification/pan-lite
Use this API to validate PAN information of individuals. The API helps verify the unique identifier, name of the individual, date of birth, and other information that helps you in customer onboarding, KYC verification, and other fraud prevention security measures. View the test data and use the information to trigger the validations. You can use the test data only in test environments such as gamma and sandbox.
PAN Statuses
| PAN Status | Description |
|---|---|
| E | The entered PAN information is valid. |
| EC | The entered PAN information exists and is valid but marked as Acquisition. |
| N | The entered PAN information does not exist in the database. |
| X | The entered PAN information has been deactivated. |
| F | The entered PAN information is fake. |
| D | The entered PAN information has been deleted. |
| EA | The entered PAN information is valid but marked as Amalgamation. |
| ED | The entered PAN information is valid but marked as Death. |
| EI | The entered PAN information is valid but marked as Dissolution. |
| EL | The entered PAN information is valid but marked as Liquidated. |
| EM | The entered PAN information is valid but marked as Merger. |
| EP | The entered PAN information is valid but marked as Partition. |
| ES | The entered PAN information is valid but marked as Split. |
| EU | The entered PAN information is valid but marked as Under Liquidation. |
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | E (VALID) | - |
| 200 | SUCCESS | EC (VALID) | - |
| 200 | SUCCESS | N (INVALID) | - |
| 200 | SUCCESS | X (INVALID) | - |
| 200 | SUCCESS | F (INVALID) | - |
| 200 | SUCCESS | D (INVALID) | - |
| 400 | ERROR | pan is missing in the request. | Enter a valid 10-character alphanumeric PAN identifier in the request. |
| 400 | ERROR | name is missing in the request. | Enter the name of the individual in the request. |
| 400 | ERROR | dob is missing in the request. | Enter the date of birth of the individual in the request. |
| 400 | ERROR | dob should be of type YYYY-MM-DD. | Enter the date of birth in the YYY-MM-DD format. |
| 400 | ERROR | verification_id is missing in the request. | Enter the verification ID to identify this API request. |
| 400 | ERROR | verification_id can include a maximum of 50 characters. | Do no exceed 50 characters while entering the verification ID. |
| 400 | ERROR | verification_id can include only alphanum, dot, hyphen and underscores. | Only alphanumeric, hyphen (-), period (.), and underscore ( _ ) are allowed. |
| 400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Enter valid client ID and secret key in the request. |
| 403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification | Whitelist the IP address. |
| 409 | ERROR | verification id already exists | Enter a unique verification ID to identify the API request. |
| 422 | ERROR | Insufficient balance to process this request. | Ensure you have sufficient balance and then process the request. |
| 500 | ERROR | something went wrong | Try again after some time. |
| 502 | ERROR | verification attempt failed | Try again after some time. |