This is a Draft
This is a Draft
This is a Draft
This is a Draft
This is a Draft
This is a Draft
Error Codes V3 Guide
Product Bundles Update
Note
This is the Error Codes document updated for Product Bundles. This feature is not in Production yet
Connect API returns conventional HTTP status codes. For a more detailed explanation of the error, Connect API provides its own error codes. Sometimes, when Precise ID is involved, PID error codes are also provided. Below is the list of the error and status codes
Status Codes
| Condition | HTTP Status | |
| Request was successfully processed | 200 | OK |
| Errors at client input that they can correct and resubmit (Example: Invalid Surname, Social not present, etc) | 400 | Bad Request |
| Authentication errors (Example: Incorrect Answers, Viewer not Authenticated, etc) | 401 | Unauthorized |
| ‘File Condition’ errors which cannot be processed further (Example: Frozen profiles, Hit on Alert list, etc) | 422 | Unprocessable Entity |
| Exceptions at Experian end for which the client has to contact us (Example: User not found in Oracle, No questions returned by PID, etc) | 500 | Internal Server Error |
| Any application (PID, Credit Reporting, etc) temporarily unavailable | 503 | Service Unavailable |
| Timeouts (Session expired or Timeouts at any of the layers) | 504 | Gateway Timeout |
Connect API Error Codes
| End Point | Error Code |
HTTP Status Code |
Error Message | Cause |
| ALL | 1001 | 500 | Internal error. {details} | API. Any Exception that does not match any of the other exceptions |
| ALL | 1004 | 500 | Invalid Request | API. API request is not properly formed |
| /v3/auth
/v3/auth/answers /v3/auth/authstatus /v3/auth/expire /v3/report /v3/report/archive /v3/share /v3/share/get /v3/user /answers /v3/pmc/answers |
1010 | 500 | User not found. Token: {0}, User ID: {1}, Company ID: {2} | API. User not found in Oracle (using User Token) |
| /v3/auth /v3/landlord /v3/pmc /v3/user |
1999 | 422 | Match on Alert List | API. Consumer Alert Match in Reseller DB when getting questions |
| /v3/auth/answers /v3/pmc/answers/v3/user/answers |
|
|
|
API. Consumer Alert Match in Reseller DB when answering questions |
| /v3/user/answers
/v3/user /v3/auth /v3/auth/answers |
2000 | 503 | Authentication Service unavailable. PID Error Code: {0} | PID. if PID error code in (258, 259, 304, 324, 352, 358, 362) OR PID Exception |
| /v3/auth /v3/user |
2001 | 422 | Auth General Error. PID Error Code: {0} | PID. if PID error code in (313, 323, 720) |
| /v3/auth | 2002 | 400 | Invalid Parameter. PID Error Code: {0} | PID. if PID error code = 708 |
| /v3/share | API. Product is not for pulling report (Valid: CreditProfile, OneFreeShareCreditProfile, NoSharableCreditProfile) | |||
| /v3/auth /v3/user /v3/landlord /v3/pmc |
2010 | 422 | Minor Consumer | PID. PID error code = 10 |
| /v3/auth /v3/auth/answers /v3/landlord /v3/user /v3/user/answers /v3/pmc /v3/pmc/answers |
2013 | 400 | Format Error | PID. PID error code = 13 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2018 | 422 | Reported as Fraud | PID. PID error code = 18 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2045 | 400 | Invalid Surname | PID. PID error code = 45 or 106 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2049 | 400 | Invalid Zipcode | PID. PID error code = 49 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2092 | 400 | State legislation requires match on more identification information | PID. PID error code = 92 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2403 | 400 | SSN Required | PID. PID error code = 403 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2404 | 400 | Generation Code Required | PID. PID error code = 404 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2405 | 400 | Year of Birth Required | PID. PID error code = 405 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2406 | 400 | Middle Name Required | PID. PID error code = 406 |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2407 | 400 | Unable to Standardize Address | PID. PID error code = 407 |
| /v3/auth /v3/auth/answers /v3/landlord /v3/user /v3/user/answers /v3/pmc /v3/pmc/answers |
2500 | 504 | Authentication Session Expired | PID. PID Session Timeout PID Service Timeout PID error code = 710 |
| /v3/auth /v3/landlord /v3/pmc /v3/user |
2501 | 422 | Exceeded limit of Authentication attempted | PID. No questions returned due to excessive use (KBAResultCode=2) |
| /v3/auth/answers /v3/pmc/answers/v3/user/answers |
2502 | 401 | Failed Authentication. PID Error Code: {0} | PID. PID Incorrect answers |
| /v3/auth /v3/auth/answers /v3/landlord /v3/user /v3/user/answers /v3/pmc /v3/pmc/answers |
2503 | 422 | Match on U.S. Department of the Treasury Office of Foreign Assets Control list. PID Error Code: {0} | PID. If OFAC Result is in (4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15) |
| /v3/auth /v3/landlord /v3/user /v3/pmc |
2627 | 400 | Invalid Street Address | PID. PID error code = 627 |
| 2633 | 400 | Address Exceeds Max Length | PID. PID error code = 633 | |
| 2711 | 400 | End user required | PID. PID error code = 711 | |
| 2709 | 400 | Invalid UserId or Password | PID. PID error code = 709 | |
| /v3/auth /v3/pmc /v3/user |
3001 | 500 | Unable to retrieve identity questions. Please verify your information and try again. PID Error Code: {0} | PID. No questions returned by PID |
| /v3/auth | 503 | PID. if PID error code is 720 (moved from 2001) | ||
| /v3/auth/answers | 3002 | 401 | User is already verified | API. User is already PID authenticaded |
| /v3/auth/answers | 3008 | 401 | Unable to verify identity. Please check the answers submitted and try again | PID. PID Incorrect answers |
| /v3/user/answers | 3009 | 504 | Your identity verification session has expired. | PID. PID session is not valid |
| /v3/user/answers | 3011 | 504 | Unable able to verify user's identity at this time. Please try again later | PID. PID session is not valid or invalid PID response |
| /v3/user | 3012 | 500 | Unable to retrieve identity questions. Please verify your information and try again | API. Subcode not found (in SSO configuration) |
| /v3/pmc /v3/user |
3014 | 422 | No Record Found | PID. No Record Found |
| /v3/landlord | 3015 | 422 | Authentication Failed | P4C authyentication failed. Check the provided consumer information. |
| /v3/auth /v3/landlord /v3/pmc /v3/user |
3901 | 422 | Consumer reported as deceased | PID. Consumer deceased (PID Score = 9001) |
| /v3/auth /v3/landlord /v3/pmc /v3/user |
3912 | 422 | Consumer/Victim Statement on-file | PID. Consumer on-file (PID Score = 9012) |
| /v3/auth /v3/landlord /v3/pmc /v3/user |
3913 | 422 | Blocked or Frozen file. PID Error Code: {0} | PID. Consumer frozen file (PID Score = 9013) |
| ALL | 7001 | 401 | Unauthorized Request | API. When SSO user is not provided |
| 401 | API. When no company is asossiated with the SSO user | |||
| ALL | 7002 | 500 | SSO security violation missing product {0} for username {1} | API. No valid SSO product name |
| ALL | 7004 | 500 | SSO security violation missing role {0} for username {1} | API. No valid SSO user role |
Common Report Error Codes
These errors are returned by report-related services as a result of validations which are not tied to any specific product.
| End Point | Error Code |
HTTP Status Code |
Error Message | Cause |
| /v3/report | 2004 | 422 | Invalid product required | API. Product is not active or Product is
not open to sell. Configuration issue. |
| /v3/report/archive | 2801 | 500 | Invalid userToken | transactionID. User ID: {0}, transaction ID: {1}, Token: {2} | API. Transaction ID and userToken do not match |
| /v3/report/archive
/v3/share |
2802 | 422 | Report Expired. User ID: {0}, transaction ID: {1} | API. Report is expired.Occurs 60 days after the report had been pulled |
| /v3/share | 2802 | 422 | Report Expired. User ID: {0}, share ID: {1} | API. Share report is expired.Occurs 60 days after the report had been shared. |
| /v3/report /v3/share |
9006 | 400 | Sharing User not found. Please check User Token. Token: {0} | API. Consumer's user not found |
| /v3/share | 9007 | 400 | Viewer User not found. Please check User Token. Viewer Token: {0} | API. Consumer's user not found |
| /v3/report /v3/report/archive /v3/share |
9008 | 500 | Unable to get valid users for your company. Please, verify tokens. Company ID: {0}, User ID: {1}, Viewer ID: {2} | API. User's company does not match SSO's |
| /v3/share /v3/report |
9009 | 400 | Invalid Sharing Purpose. Purpose Type ID: {0} | API. Sharing purpose type is not in the list (configured in API's DB) |
| /v3/report | 9010 | 401 | User is not authenticated. Please complete authentication process. User ID: {0} | API. User not authenticated |
| /v3/share/get | 9011 | 401 | Viewer is not authenticated. Please complete authentication process. Viewer ID: {0} | API. Viewer not authenticated |
| /v3/share | 9012 | 500 | Invalid Transaction Id. User ID: {0}, Transaction ID: {1} | API. Transaction not found in oracle DB |
| /v3/share | 9014 | 422 | Product not sharable. Product ID: {0}, Transaction ID: {1} | API. Product not available for sharing |
| /v3/share/get | 9015 | 422 | Report expired. User ID: {0}, Transaction ID: {1} | API. Report shared for more than 60 days |
| /v3/share/get | 9016 | 422 | Report not found. User ID: {0}, Transaction ID: {1} | API. Shared report not found |
| /v3/report | 9018 | 422 | <field> is required when requesting <product> | <field> is required if you want to request
<product> <field> is a Consumer attribute, so you need to register the consumer again, taking care of providing the required fields for <product> |
Credit Profile Errors
These errors are returned by report-related endpoints when pulling a Credit Profile report or a bundle which includes Credit Profile. For standalone Credit Profile (product IDs 1 and 9), these errors will be located at the root of the response. When Credit Profile is part of a bundle, these errors will be located in the CreditProfile section of the Bundle Response.
| End Point | Error Code |
HTTP Status Code |
Error Message | Cause |
| /v3/report/v3/share | 9003 | 500 | Unable to retrieve CustomerMaster Subscription data | API. Empty response or invalid input for Subscription data |
| /v3/report /v3/report/archive /v3/share |
9004 | 500 | Unable to build CreditReport inquiry | Report. Error when pulling or parsing Credit Report |
| /v3/report /v3/share |
9005 | 422 | Service unavailable | Report. File One Connection error |
| /v3/report/v3/share | 9002 | 500 | Company not properly configured in CustomerMaster database | API. No subcode in Customer Master |
| /v3/share | 9001 | 500 | Company not properly configured in EWACS | API. No Subcode in SSO |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
9110 | 422 | Consumer is a Minor | Report |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
9116 | 422 | File Blocked | Report |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
9132 | 422 | File Locked | Report |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
9193 | 422 | No record found | Report |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10015 | 500 | AMT- AMOUNT FIELD FORMAT ERROR | Report. When error code 015 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10019 | 500 | EMPLOYMENT FIELD FORMAT ERROR | Report. When error code 019 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10031 | 500 | INVALID SUBSCRIBER NUMBER | Report. When error code 031 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10037 | 500 | INVALID YOB | Report. When error code 037 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10043 | 500 | INVALID USE OF QUEST TYPE CODE | Report. When error code 043 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10045 | 500 | INVALID SURNAME | Report. When error code 045 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10047 | 400 | CURRENT HOUSE NUMBER ERROR | Report. When error code 047 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10049 | 400 | CURRENT ZIP CODE ERROR | Report. When error code 049 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10053 | 500 | INVALID SOCIAL SECURITY NUMBER | Report. When error code 053 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10054 | 400 | PREVIOUS HOUSE NUMBER ERROR | Report. When error code 054 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10055 | 400 | INVALID PREVIOUS STREET ADDRESS FIELD | Report. When error code 055 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10056 | 400 | PREVIOUS ZIP CODE ERROR | Report. When error code 056 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10061 | 500 | INVALID GENERATION CODE | Report. When error code 061 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10067 | 500 | SUBSCRIBER NOT ALLOWED TO INQUIRE | Report. When error code 067 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10073 | 400 | ZIP CODE REQUIRED | Report. When error code 073 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10092 | 400 | STATE LEGISLATION REQUIRES MATCH ON MORE IDENTIFICATION INFORMATION | Report. When error code 092 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10130 | 500 | SPOUSE EMPLOYMENT FORMAT ERROR | Report. When error code 130 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10139 | 500 | INVALID SPOUSE SOCIAL SECURITY NUMBER | Report. When error code 139 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10173 | 500 | INVALID INQUIRY TYPE FOR REPORT CODE | Report. When error code 173 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10216 | 400 | FULL ADDRESS REQUIRED TO REQUEST AP/RETAIL | Report. When error code 216 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10222 | 500 | YOUR SUBS ACCESS NO. IS INACTIVE | Report. When error code 222 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10402 | 400 | *** FULL CURRENT ADDRESS REQUIRED TO ACCESS CONSUMERS FILE *** | Report. When error code 402 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10403 | 400 | SS# REQUIRED TO ACCESS CONSUMERS FILE | Report. When error code 403 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10404 | 400 | GENERATION CODE REQUIRED TO ACCESS CONSUMERS FILE | Report. When error code 404 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10405 | 400 | YEAR OF BIRTH REQUIRED TO ACCESS CONSUMERS FILE | Report. When error code 405 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10406 | 400 | MIDDLE NAME REQUIRED TO ACCESS CONSUMERS FILE | Report. When error code 406 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10407 | 400 | UNABLE TO STANDARDIZE CURRENT ADDRESS | Report. When error code 407 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10408 | 400 | ADDRESS FIELD INVALID | Report. When error code 408 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10616 | 400 | INVALID LAST/FIRST/MIDDLE NAME | Report. When error code 616 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10621 | 500 | INVALID SPOUSE NAME | Report. When error code 621 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10627 | 400 | INVALID STREET ADDRESS FIELD | Report. When error code 627 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10630 | 400 | CITY/STATE REQUIRED FOR INQUIRY TYPE H | Report. When error code 630 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10631 | 500 | PRIMARY NAME LINE EXCEEDS MAX SIZE | Report. When error code 631 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10632 | 500 | SPOUSE NAME: LENGTH INVALID | Report. When error code 632 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10633 | 500 | CURR/BILLING ADDRESS LINE EXCEEDS MAX SIZE | Report. When error code 633 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10634 | 500 | PREV/SERVICE ADDRESS LINE EXCEEDS MAX SIZE | Report. When error code 634 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10639 | 500 | INQUIRY TYPE INVALID FOR THIS SUBCODE | Report. When error code 639 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10653 | 500 | *** END-USER IDENTIFICATION REQUIRED *** | Report. When error code 653 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10901 | 500 | INSUFFICIENT DATA SUPPLIED | Report. When error code 901 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10936 | 500 | INQUIRY TYPE / SUBCODE CONFLICT | Report. When error code 936 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10945 | 500 | ORIGINAL CREDITOR EXCEEDS 30 CHARACTERS | Report. When error code 945 is returned from File One |
| /v3/report /v3/share/get /v3/report/archive /v3/share |
10946 | 500 | ORIGINAL CREDITOR REQUIRED FOR COLLECTION AGENCIES | Report. When error code 946 is returned from File One |
Background Data Errors
| End Point | Error Code |
Status Code |
Error Message | Cause |
| /v3/report /v3/report/archive /v3/share/get /v3/share |
9999 | 500 | Eviction search is unavailable. Please try again later. | Backend error. |
| /v3/report |
9018 | 422 | ssn is required when requesting
BackgroundData dob is required when requesting BackgroundData |
Consumer's SSN and DOB are required for pulling a Background Data report. You didn't include them when registering the consumer. |
| /v3/report /v3/report/archive /v3/share/get /v3/share |
9989 | 422 | Criminal report is not currently available. Please try again after 2 business days. | Dispute
in progress. |
| /v3/report /v3/report/archive /v3/share/get /v3/share |
9988 | 422 | Eviction report is not currently available. Please try again after 2 business days. | Dispute
in progress. |
| /v3/report | 9995 | 422 | Invalid SSN . Please try again. | 'Invalid SSN' error returned by Criminal Report |
| /v3/report | 9996 | 422 | Invalid Date of Birth . Please try again . | 'Invalid Date of Birth' error returned by Criminal Report |
| /v3/report /v3/report/archive/v3/share/get /v3/share |
9997 | 500 | System error . Please try again later. | System Error returned by Criminal Report |
| ANY | 9987 | 500 | An account with CIC is required. | We couldn't find a CIC account for your company. |
PID Error Codes
| Code | Description |
| 10 | Consumer is a minor |
| 13 | Format error |
| 18 | Information on the inquiry was reported as fraud by the consumer |
| 45 | Invalid surname |
| 49 | Current ZIP Code error |
| 92 | State legislation requires match on more identification information |
| 106 | Invalid surname |
| 258 | One or more requested reports unavailable at this time – Please resubmit later |
| 259 | Components of checkpoint system temporarily unavailable. Please resubmit |
| 304 | *** NFD temporarily unavailable. Please resubmit *** (for the NFD Only product option) |
| 313 | NFD does not process inquiries with a Colorado ZIP Code (for the NFD Only product option) |
| 323 | Not all data available for Experian Detect evaluation |
| 324 | Experian Detect temporarily unavailable |
| 352 | Precise ID system temporarily unavailable |
| 358 | Fraud Shield unavailable |
| 362 | Credit Reporting temporarily unavailable |
| 403 | SSN required to access consumer’s file |
| 404 | Generation code required to access consumer’s file |
| 405 | Year of Birth require to access consumer’s file |
| 406 | Middle name require to access consumer’s file |
| 407 | Unable to standardize current address |
| 627 | Invalid street address filed |
| 633 | Current Address exceeds maximum length |
| 708 | Input validation error |
| 709 | Invalid User ID/Password |
| 710 | Session timeout (for KIQ product options only). |
| Note: 710 may also be returned if the Session ID does not exist (for KIQ product responses only). | |
| 711 | End User is required |
| 720 | Other Precise ID system error |