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. |