> ## Documentation Index > Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt > Use this file to discover all available pages before exploring further. # API Error Codes The FrankieOne standard [ErrorObject](/docs/introduction/reference/errors) 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. ##### Note on Error Codes 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 the developer support team for further assistance. If this is the case, see here: [Contacting Developer Support](docs/contacting-developer-support) In the API responses the error number will come combined with the issue code for example `ENT-1065` or `VAL-1010` ## 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 | Authorization/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) isn't supported for your current configuration. Contact developer support. | | 0013 | 501 | Requested service (scan) isn't supported for your current configuration. Contact developer support. | | 0014 | 501 | Requested service (document verify) isn't supported for your current configuration. Contact developer support. | | 0015 | 501 | Requested service (industry function) isn't supported for your current configuration. Contact developer support. | | 0016 | 501 | Requested service (entity verify) isn't supported for your current configuration. Contact developer support. | | 0017 | 501 | Requested service (specific entity check type) isn't 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 | Can't merge different documents or entities | | 1004 | 400 | Can't set document ID | | 1005 | 400 | Data conversion issue | | 1006 | 422 | Document supplied is unparsable | | 1007 | 400 | Can't set entity ID | | 1008 | 400 | Entity supplied is unparsable | | 1009 | 404 | Requested document isn't found | | 1010 | 404 | Requested entity isn't found | | 1011 | 422 | Not enough data supplied to perform requested check | | 1012 | 500 | Can't 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 couldn't 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 isn't 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 couldn't continue because required data was modified | | 1057 | 500 | The background operation couldn't 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 | Can't 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 couldn't 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 doesn't have an assigned profile | | 1067 | 400 | Entity profiles aren't 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 isn't 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 | | 1083 | 500 | Failed to get JWT signer or JWK key set | | 1084 | 400 | Entity not in valid state for setting a manual state | | 1085 | 404 | Requested entity isn't retrievable at this time. **NOTE:** This is *USUALLY* transient, so wait 5 seconds and then retry | | 1086 | 404 | Requested association doesn't exist | | 1087 | 400 | Requested association isn't allowed | | 1088 | 400 | Object not found from non-primary key search | | 1089 | 500 | Internal error. Contact developer support. | | 1090 | 400 | Device data supplied is either missing or incorrectly formatted | | 1091 | 500 | Internal service error - please contact technical support | | 1092 | 404 | Organisation can't be found in the requested country's registry | | 1093 | 400 | The request contains an invalid parameter or argument | | 1094 | 400 | Search criteria too broad and returned too many results. Please retry with narrower search criteria | | 1095 | 400 | Incorrectly formatted organisation number | | 1096 | 400 | The requested country registry is incorrect. Please ensure you have the right country registry code | | 1097 | 503 | Unknown response from the registry | | 1098 | 400 | No company registry for the requested country is available to query. This is often due to local regulations not making this data available | | 1099 | 400 | Search by organisation\_number not available for the jurisdiction | | 1100 | 400 | This is reserved for future error handling | | 1101 | 400 | This is reserved for future error handling | | 1102 | 400 | This is reserved for future error handling | | 1103 | 400 | This is reserved for future error handling | | 1104 | 400 | This is reserved for future error handling | | 1105 | 400 | This is reserved for future error handling |