Error Codes

The Frankie standard ErrorObject has a field called “ErrorCode” which is made up of a prefix and a 4 digit number.

The prefix is the Issue Location, and describes the system domain, layer or service where the issue has occurred.

The 4 digit number is the error code itself. These are shared across all domains.

The tables below will describe the issue locations and error codes. In a number of cases, it suggests you contact developer support. If this is the case, see here: Contacting Developer Support

Issue Location Codes

Issue Location

Description

CODE

Errors detected in the code. Indicates something unexpected has occurred. Please contact support as per the details below.

AUTH

Authorisation / security related errors

SYS

System level errors. Please contact support if you repeatedly get these errors.

API

Errors in your API message. Indicates an incorrectly constructed message

VAL

API Data validation errors. See the issue details for more.

DOC

Errors related directly to Document functions

ENT

Errors related directly to Entity functions

CHECK

Errors related to Check/Verify functions - Indicates potential issues with a check you’re trying to perform, rather than the results of a check per se.

ADMIN

Admin API errors. Please contact developer support should you receive one of these errors

Error Numbers

The following sections cover the different groups of error numbers we use

System Errors (0000 - 0399)

Returned by internal processes. Generally indicate a temporary issue, but please contact developer support if the issue persists.

Error Number

HTTP Error Code

Description

0000

500

Unknown internal error. Contact developer support

0001

500

Internal error. Contact developer support.

0002

401

Not authorised to perform this function

0003

500

Internal error. Contact developer support.

0004

500

Internal error. Contact developer support.

0005

500

Internal error. Contact developer support.

0006

500

Internal error. Contact developer support.

0007

503

No service providers available/configured. Contact developer support

0008

503

No document scanning service available/configured. Contact developer support

0009

503

No document verification service available/configured. Contact developer support

0010

503

No comparison service available/configured. Contact developer support

0011

503

No industry service available/configured. Contact developer support

0012

501

Requested service (comparison) is not supported for your current configuration. Contact developer support.

0013

501

Requested service (scan) is not supported for your current configuration. Contact developer support.

0014

501

Requested service (document verify) is not supported for your current configuration. Contact developer support.

0015

501

Requested service (industry function) is not supported for your current configuration. Contact developer support.

0016

501

Requested service (entity verify) is not supported for your current configuration. Contact developer support.

0017

501

Requested service (specific entity check type) is not supported for your current configuration. Contact developer support.

0018

503

No entity verification service available/configured. Contact developer support

0019

503

Internal error. Contact developer support.

0020

500

Internal error. Contact developer support.

0021

500

Internal error. Contact developer support.

0022

500

Internal error. Contact developer support.

0023

500

Internal error. Contact developer support.

0024

500

Internal error. Contact developer support.

0025

500

Internal error. Contact developer support.

0026

500

Internal error. Contact developer support.

0027

500

Internal error. Contact developer support.

0028

500

Internal error. Contact developer support.

0029

500

Internal error. Contact developer support.

0030

500

Internal error. Contact developer support.

0031

500

Internal error. Contact developer support.

0032

500

Cache retrieve error. Contact developer support.

0033

500

Internal error. Contact developer support.

0034

500

Internal error. Contact developer support.

0035

503

Push to mobile service not available

Generic Errors (0400 - 0599)

Returned when no distinct error code is available (usually internal framework generated)

Error Number

HTTP Error Code

Description

400

400

Generic 400 Error - See error message for details

401

401

Generic 401 Error - See error message for details

404

404

Generic 404 Error - See error message for details

405

405

Generic 405 Error - See error message for details

415

415

Generic 415 Error - See error message for details

422

422

Generic 422 Error - See error message for details

429

429

Generic 429 Error - See error message for details

500

500

Generic 500 Error - See error message for details

501

501

Generic 501 Error - See error message for details

503

503

Generic 503 Error - See error message for details

Header Errors (0800 - 0999)

Returned when unsupported/missing header data is supplied

Error Number

HTTP Error Code

Description

801

400

Missing header: RequestID

802

400

Missing header: CheckID

901

400

Malformed header: RequestID

902

400

Malformed header: CheckID

Application & Service Errors (1000 - )

These errors are returned when there is an issue with a specific request

Error Number

HTTP Error Code

Description

1001

400

Blank value supplied when one needed

1002

400

Data supplied is incorrect/badly formatted.

1003

405

Cannot merge different documents or entities

1004

400

Cannot set document ID

1005

400

Data conversion issue

1006

422

Document supplied is unparsable

1007

400

Cannot set entity ID

1008

400

Entity supplied is unparsable

1009

404

Requested document is not found

1010

404

Requested entity is not found

1011

422

Not enough data supplied to perform requested check

1012

500

Cannot mark record as deleted

1013

400

Utility bill not supplied

1014

400

Document not a PDF when PDF expected

1015

400

Scan data not supplied when scan expected

1016

501

Error response returned from utility processor

1017

202

Verification results incomplete - expect a notification push

1018

415

Media type not supported

1019

400

End date before start date

1020

400

Bad page number

1021

400

Bad page count request

1022

404

Requested check ID not found

1023

404

Can’t retrieve original document

1024

404

Cache returned a nil result

1025

400

Geocode empty

1026

400

Multiple geocode results or inexact address match

1027

400

Bad geocode result - Address not found

1028

400

Invalid country or country code

1029

401

Attempt to access unauthorised data

1030

400

Entity state precludes requested flag setting

1031

 

Reserved

1032

 

Reserved

1033

 

Reserved

1034

 

Reserved

1035

 

Reserved

1036

 

Reserved

1037

 

Reserved

1038

 

Reserved

1039

 

Reserved

1040

 

Reserved

1041

400

Identity document required

1042

400

Incorrect ID type

1043

400

Missing mobile number

1044

400

Missing name

1045

400

Empty name

1046

400

Entity ineligible for service or in unsupported jurisdiction

1047

400

Push to Mobile service returned PTM service offline

1048

404

PTM service could not find the token requested

1049

404

Internal error. Contact developer support.

1050

503

No business query service available at this time.

1051

503

Failed to schedule background job

1052

500

Business processor returned empty result set

1053

400

Supplied entity is not of a suitable type

1054

400

The requested operation amounted to no work

1055

400

A required prior result has expired

1056

500

The background operation could not continue because required data was modified

1057

500

The background operation could not continue because required data was missing

1058

500

No result was obtained in a reasonable time

1059

500

Inconsistent result from business processor

1060

400

Mismatch between ownership request and ABR response

1061

400

Cannot change status of check result

1062

403

Operation not permitted, entity is in inactive state

1063

500

Report service exists but failed to generate a report or we could not save the result

1064

400

Document not owned by entity requested in document/verify function

1065

400

Named entity profile not configured

1066

400

Entity does not have an assigned profile

1067

400

Entity profiles are not enabled for customer

1068

400

Missing application id or referrer when requesting an IDV token

1069

400

Invalid request to token service for a token

1070

422

Invalid request (unprocessable) to token service for a token

1071

500

Reserved

1072

400

Refresh token with mismatch applicant id

1073

500

The expected or default policy is not configured

1074

500

Attempt to toggle entity monitoring failed

1075

422

Importing past results failed

1076

400

Unknown business reportType

1077

503

No intl business service available

1078

400

No intl business search/profile criteria provided

1079

400

Intl business service rejected request

1080

400

No shared blocklist

1081

400

No shared blocklist reason

1082

500

Shared blocklist internal error


Did this page help you?