Result and Error Codes
​
Jobs are made up of Actions, and each Action has a key value pair:
But every Job also has an overall result, which is summarized in the Result Code.
If you prefer to use Smile Identity's binary results instead of interpreting individual Actions you can use Result Codes to build your business logic.
Result Codes for all jobs fall into one of three categories:
Approved (or Pass) This this means that all applicable Actions passed and the overall job was approved.
Provisionally Approved (or Pending) This means that the job is awaiting a human review, or that a human review was inconclusive or that part of a job passed but another part was unable to be completed. You can treat these jobs as Approved or you handle them based on the Result Code. Please note a
Pure Provisionalresult is a provisionally approved job, but one in which the image comparison Action was provisionally approved but the identity validation Action failed or could not return data. Also note, aPending Approvalresult is a custom Strict setting where the user cannot progress in the system without a human review being completed on the Pending job.Rejected (or Fail) This means that one or more of the applicable Actions for job failed, and thus, the overall job was rejected according to Smile Identity standards.
​
Result Codes
General
Code | Description | Result |
0001 | Data Invalid | Rejected |
0903 | Zip Corrupt | Rejected |
0907 | FAIL - Possible Spoof - Strict Setting | Rejected |
2305 | "You are not authorized to do that" * | Rejected |
2314 | Error - No Zip File Received | Rejected |
* If you are seeign this error, check the Moving to Production section to ensure that you have changed your API Key and completed the Smile Identity Partner KYC check. If you are seeing this error and are not using one of our open-source server-side libraries (Java, Ruby, Javascript), you may be miscalculating the Security Key.
​
Job Type 1 - Register With ID
Code | Description | Result |
0908 | Issuer not available | Rejected |
0911 | No Face Found | Rejected |
0912 | Image Quality Judged Too Poor | Rejected |
0810 | Machine Judgement - PASS | Approved |
0811 | Machine Judgement - FAIL - Compare Rejected | Rejected |
0812 | Machine Judgement - Pure Provisional | Provisionally Approved |
0813 | Machine Judgement - FAIL, Possible Spoof - Settings Based on Normal/Strict/Custom | Rejected |
0814 | Machine Judgement - Provisional - Possible Spoof | Provisionally Approved |
0815 | Machine Judgement - Provisional - Compare Unsure | Provisionally Approved |
0816 | Machine Judgement - Pending - Possible Spoof | Pending |
0817 | Machine Judgement - Pending - Compare Unsure | Pending |
1210 | Human Judgement - PASS - Settings Based on Normal/Strict/Custom | Approved |
1211 | Human Judgement - FAIL - Human Compare Failed | Rejected |
1212 | Human Judgement - Spoof Detected | Rejected |
1213 | Human Judgement - Provisional - Liveliness Unsure | Provisionally Approved |
Job Type 2 - Authentication
Code | Description | Result |
0921 | FAIL - No Face Found | Rejected |
0922 | FAIL - Image Quality Judged Too Poor | Rejected |
0820 | Machine Judgement - PASS | Approved |
0821 | Machine Judgement - FAIL - COMPARISON | Rejected |
0822 | Machine Judgement - PURE PROVISIONAL | Provisionally Approved |
0823 | Machine Judgement - FAIL - Possible Spoof | Rejected |
0824 | Machine Judgement - PROVISIONAL - Possible Spoof | Provisionally Approved |
0825 | Machine Judgement - PROVISIONAL - Machine Compare Unsure | Provisionally Approved |
0826 | Machine Judgement - PENDING - Possible Spoof | Pending |
0827 | Machine Judgement - PENDING - Machine Compare Unsure | Pending |
1220 | Human Judgement - PASS | Approved |
1221 | Human Judgement - FAIL - Human Compare Failed | Rejected |
1222 | Human Judgement - FAIL - Spoof Detected | Rejected |
Job Type 4 - Register Without ID
Code | Description | Result |
0941 | FAIL - No Face Found | Rejected |
0942 | FAIL - Image Quality Judged Too Poor | Rejected |
0840 | PASS - Machine Judgement | Approved |
0841 | FAIL - Machine Judgement - Compare Failed | Rejected |
0842 | PROVISIONAL - Machine - Pure Provisional | Provisionally Approved |
0843 | FAIL - Possible Spoof - Machine Judgement - Settings based on normal/strict/custom | Rejected |
0844 | PROVISIONAL - Possible Spoof - Machine Judgement | Provisionally Approved |
0846 | PENDING - Possible Spoof - Machine Judgement | Pending |
1240 | PASS - Human Judgement | Approved |
1241 | FAIL - Image Unuseable | Rejected |
1242 | Spoof detected - Human Judgement | Rejected |
Job Type 8 - Update Photo
Code | Description | Result |
0981 | FAIL - No Face Found | Rejected |
0982 | FAIL - Image Quality Judged Too Poor | Rejected |
0880 | PASS - Machine judgement | Approved |
0881 | FAIL - COMPARE - Machine judgement | Rejected |
0882 | Partner Review Required | Provisionally Approved |
0883 | FAIL - Possible Spoof - Machine Judgement | Rejected |
0884 | PROVISIONAL - Possible Spoof - Machine Judgement | Provisionally Approved |
0886 | PENDING - Possible Spoof - Machine Judgement | Pending |
1280 | PASS- Human Judgement | Approved |
1281 | FAIL - Human Judgement | Rejected |
1282 | Spoof Detected - Human Judgement | Rejected |
Job Type 5 - ID Validation
Code | Description | Result |
1012 | Success | Approved |
1013 | Invalid ID | Rejected |
1014 | Unsupported ID Type and/or Country | Rejected |
1015 | Error - Queried Database Unavailable | Rejected |
1016 | Need to Activate Product | Rejected |
​
​
Job Status
Code | Description | Result |
2401 | Error - System Error | Rejected |
2403 | Error - Invalid JSON | Rejected |
2413 | Error - Missing Required Field | Rejected |
2405 | Error - Invalid Signature (sec_key) | Rejected |
2412 | Error - Invalid Job Type | Rejected |
2414 | Error - Product Activation Required | Rejected |