Use Attestr AI / ML model for instant classification and recognition of identity document images.
Following images constraints are enforced for better accuracy of classification algorithm.
- Maximum allowed image size is 10 MB.
- Minimum image dimensions are 200 x 200 pixels.
- Only JPEG and PNG images are supported.
| Type | URL |
|---|
| Post | https://api.attestr.com/api/{version}/public/xtract/classify |
| Type | Name | Description | Optional (Default) | Min Version | Max Version |
|---|
| String | src | Media document ID | Required | v1 | |
| String | label | label to identify. Following labels are supported.
UIDAI - For Aadhaar document
PAN - For PAN card
PP - For passport | Required | v1 | |
| Number | threshold | Threshold value. Classification is considered valid for the input label if output confidence is more than specified threshold value. Allowed values are float number 0.1 to 1.0 with 1 digit precision after decimal. | Optional | v1 | |
| Type | Name | Value / Description | Optional | Min Version | Max Version |
|---|
| String | Content-Type | application/json | Required | v1 | |
| String | Authorization | Basic {authToken} | Required | v1 | |
If you do not have the authentication token, please refer to Register App to generate one.
Http Status Code 200
| Key | Description | Type | Min Version | Max Version |
|---|
| valid | Boolean to check if the input media image matches the specified input label. False if the label does not match. | Boolean | v1 | |
| confidence | Confidence outcome from AI model while predicting the image type, specifies how likely the image matches the input label. | Number | v1 | |
| label | Same as input label | String | v1 | |
| suggestedLabel | The suggested label for the input media document, if the input label does not match. The possible values are UIDAI, PAN, PP, OTHER. | String | v1 | |
| suggestedLabelConfidence | Confidence level for the suggested label if available | Number | v1 | |
Valid Match
Invalid Match
| Parameter | Type | Description |
|---|
| code | Number | Unique error codes for different errors. Always available. |
| message | String | Error message describing the error. Always Available. |
| details | String | Detail error message. Available only for certain types of errors. |
| HTTP Status | Error Code | Error Message |
|---|
| 400 | 4001 | Malformed data or missing required parameter values |
| 400 | 4005 | Operation could not be performed due to low credits balance |
| 401 | 4016 | Invalid client authorization |
| 403 | 4031 | Unauthorized access |
| 403 | 4035 | Requested service is not provisioned for your account |
| 403 | 4039 | Client's IP address is not whitelisted |
| 429 | 4291 | Maximum account rate limit exceeded |
| 429 | 4292 | Maximum API rate limit exceeded |
| 429 | 4293 | Maximum account daily limit exceeded |
| 429 | 4294 | Maximum API daily limit exceeded |
| 500 | 5001 | Request could not be processed |
