post https://sandbox.crimescan.ai/v1/api_hub/pan_l1
The PAN (Basic) offers advanced verification of Permanent Account Number (PAN) details. It provides comprehensive validation by cross-checking the PAN with additional data points, such as the holder's name, date of birth, and father's name. This API is ideal for enhanced KYC checks and ensures a higher level of accuracy and fraud prevention in identity verification.
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. |
| 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. |
