Error Code Changes for US Government Verification
Upcoming Changes: Demo March 30, Production April 6, 2026
We are updating the error code definitions and response statuses for the US Government Verification module. These changes are designed to improve result explainability, reduce ambiguity, and make it easier to interpret session outcomes in the Omni Dashboard and via API responses.
What's Changing
1. Status Changes: FAIL → UNKNOWNfor select error codes.
FAIL → UNKNOWNfor select error codes.Several error codes that previously returned a FAIL status will now return UNKNOWN. This better reflects that these outcomes are not a definitive verification failure, rather they indicate the verification could not be completed due to missing inputs, configuration issues, or connectivity problems.
| Error Code | Description | Old Status | New Status |
|---|---|---|---|
providerNotConfigured | Provider is not configured or incorrectly configured for this flow | FAIL | UNKNOWN |
missingDocumentId | Document number missing or has an invalid pattern | FAIL | UNKNOWN |
invalidExpirationDate | Expiration date is not valid per document standards | FAIL | UNKNOWN |
notEnoughData | One or more required fields are missing or invalid | FAIL | UNKNOWN |
missingSelfie | Provider requires selfie for processing but not provided in session | FAIL | UNKNOWN |
connectionError | Error occurred during processing within provider environment | FAIL | UNKNOWN |
infrastructureError | Error occurred during processing within Incode environment | FAIL | UNKNOWN |
2. Deprecated Error Codes & New Mapping
The following error codes are being deprecated. They will no longer be returned. Sessions that would have previously triggered these codes will now return one of the more specific replacement codes listed below.
| Deprecated Code | Old Description | Now Mapped To |
|---|---|---|
validationError | Grouped validation failure covering: record not found, data mismatch, restricted record, or face match failed | userNotFound, faceComparisonFailed (more specific codes per actual failure reason) |
providerUnavailable | DMV or AAMVA provider service unavailable or credentials invalid | connectionError |
3. Updated Error Descriptions
Some error codes retain the same status but have updated descriptions for improved clarity. No behavioral changes are associated with these, only the human-readable description has been refined. Refer to the full table of error codes for details.
Error Code Table
Error Code | Description |
|---|---|
| Provider Not Configured |
| Missing Document Number |
| Invalid Expiration Date |
| Missing Required Data |
| Missing Selfie |
| Document Type Not Supported |
| Country Not Supported |
| State Not Supported |
| Provider Connection Error |
| Incode Processing Error |
| User Not Found |
| Face Match Failed |
What's NOT Changing
- The API interface is unchanged. Error codes continue to be returned in the same fields and same response structure. This update is fully backwards compatible, no integration changes are required.
- Error codes remain available in Business Rules. All error codes (including newly renamed and updated ones) continue to be exposed in Business Rules, so you can configure
FAILorUNKNOWNhandling as needed. - Error codes remain unchanged for non US connections. The error codes for all non US government verification connections remain unchanged.
- Billing behavior is unchanged for all affected codes.
Action Required
If your implementation uses the impacted error codes for downstream decisioning logic or alerting, please review the status changes listed above and update your logic accordingly.
If you prefer to continue failing sessions that now return
UNKNOWN(e.g.,connectionError), you can configure this via Business Rules without any code changes on your end.
Questions?
Reach out to your Incode integration contact or submit a support request if you have questions about how these changes may affect your specific implementation.
Updated about 2 hours ago