Result and Error Codes

Detailed result codes to build and debug your business logic

Jobs are made up of Actions, and each Action has a key value pair:

Each Action has a Key Value Pair

But every Job also has an overall result, which is summarized in the Result Code.

Every Job also has an Overall Result

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:

  1. Approved (or Pass) This this means that all applicable Actions passed and the overall job was approved.

  2. 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 Provisional result 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, a Pending Approval result is a custom Strict setting where the user cannot progress in the system without a human review being completed on the Pending job.

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