Error Codes V3 Guide

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
ANY 2004 422 Invalid product required API. Product is not active or Product is not open to sell.

Configuration issue.
/v3/share  
  API. Product is not for pulling report (Valid: CreditProfile, OneFreeShareCreditProfile,   NoSharableCreditProfile)
/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/get 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/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/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 (7, 8)
/v3/auth
/v3/landlord
/v3/user
/v3/pmc
2627 400 Invalid Street Address PID. PID error code = 627
/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/user/answers        
/v3/auth        
/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/auth/answers         
/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/auth        
/v3/user/answers        
/v3/auth/answers        
/v3/share        
/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)
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
/v3/share 9001 500 Company not properly configured   in EWACS  API. No Subcode in SSO
/v3/report        
/v3/auth/answers        
/v3/auth        
/v3/report/v3/share 9002 500 Company not properly configured   in CustomerMaster database API. No subcode in Customer Master
/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
9006 400 Sharing User not found. Please check User Token. Token: {0} API. Consumer's user not found
/v3/report
/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
/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
         
10015 500 AMT- AMOUNT FIELD FORMAT ERROR Report. When error code 015 is returned   from File One
48 10019 500 EMPLOYMENT FIELD FORMAT ERROR Report. When error code 019 is returned   from File One
49 10031 500 INVALID SUBSCRIBER NUMBER Report. When error code 031 is returned   from File One
50 10037 500 INVALID YOB Report. When error code 037 is returned   from File One
51 10043 500 INVALID USE OF QUEST TYPE CODE Report. When error code 043 is returned   from File One
52 10045 500 INVALID SURNAME Report. When error code 045 is returned   from File One
53 10047 400 CURRENT HOUSE NUMBER ERROR Report. When error code 047 is returned   from File One
54 10049 400 CURRENT ZIP CODE ERROR Report. When error code 049 is returned   from File One
55 10053 500 INVALID SOCIAL SECURITY NUMBER Report. When error code 053 is returned   from File One
56 10054 400 PREVIOUS HOUSE NUMBER ERROR Report. When error code 054 is returned   from File One
57 10055 400 INVALID PREVIOUS STREET ADDRESS   FIELD Report. When error code 055 is returned   from File One
58 10056 400 PREVIOUS ZIP CODE ERROR Report. When error code 056 is returned   from File One
59 10061 500 INVALID GENERATION CODE Report. When error code 061 is returned   from File One
60 10067 500 SUBSCRIBER NOT ALLOWED TO   INQUIRE Report. When error code 067 is returned   from File One
61 10073 400 ZIP CODE REQUIRED Report. When error code 073 is returned   from File One
62 10092 400 STATE LEGISLATION REQUIRES MATCH   ON MORE IDENTIFICATION INFORMATION Report. When error code 092 is returned   from File One
63 10130 500 SPOUSE EMPLOYMENT FORMAT ERROR Report. When error code 130 is returned   from File One
64 10139 500 INVALID SPOUSE SOCIAL SECURITY   NUMBER Report. When error code 139 is returned   from File One
65 10173 500 INVALID INQUIRY TYPE FOR REPORT   CODE Report. When error code 173 is returned   from File One
66 10216 400 FULL ADDRESS REQUIRED TO REQUEST   AP/RETAIL Report. When error code 216 is returned   from File One
67 10222 500 YOUR SUBS ACCESS NO. IS INACTIVE Report. When error code 222 is returned   from File One
68 10402 400 *** FULL CURRENT ADDRESS   REQUIRED TO ACCESS CONSUMERS FILE *** Report. When error code 402 is returned   from File One
69 10403 400 SS# REQUIRED TO ACCESS CONSUMERS   FILE Report. When error code 403 is returned   from File One
70 10404 400 GENERATION CODE REQUIRED TO   ACCESS CONSUMERS FILE Report. When error code 404 is returned   from File One
71 10405 400 YEAR OF BIRTH REQUIRED TO ACCESS   CONSUMERS FILE Report. When error code 405 is returned   from File One
72 10406 400 MIDDLE NAME REQUIRED TO ACCESS   CONSUMERS FILE Report. When error code 406 is returned   from File One
73 10407 400 UNABLE TO STANDARDIZE CURRENT   ADDRESS Report. When error code 407 is returned   from File One
74 10408 400 ADDRESS FIELD INVALID Report. When error code 408 is returned   from File One
75 10616 400 INVALID LAST/FIRST/MIDDLE NAME Report. When error code 616 is returned   from File One
76 10621 500 INVALID SPOUSE NAME Report. When error code 621 is returned   from File One
77 10627 400 INVALID STREET ADDRESS FIELD Report. When error code 627 is returned   from File One
78 10630 400 CITY/STATE REQUIRED FOR INQUIRY   TYPE H Report. When error code 630 is returned   from File One
79 10631 500 PRIMARY NAME LINE EXCEEDS MAX   SIZE Report. When error code 631 is returned   from File One
80 10632 500 SPOUSE NAME: LENGTH INVALID Report. When error code 632 is returned   from File One
81 10633 500 CURR/BILLING ADDRESS LINE   EXCEEDS MAX SIZE Report. When error code 633 is returned   from File One
82 10634 500 PREV/SERVICE ADDRESS LINE   EXCEEDS MAX SIZE Report. When error code 634 is returned   from File One
83 10639 500 INQUIRY TYPE INVALID FOR THIS   SUBCODE Report. When error code 639 is returned   from File One
84 10653 500 *** END-USER IDENTIFICATION   REQUIRED *** Report. When error code 653 is returned   from File One
85 10901 500 INSUFFICIENT DATA SUPPLIED Report. When error code 901 is returned   from File One
86 10936 500 INQUIRY TYPE / SUBCODE CONFLICT Report. When error code 936 is returned   from File One
87 10945 500 ORIGINAL CREDITOR EXCEEDS 30   CHARACTERS Report. When error code 945 is returned   from File One
88 10946 500 ORIGINAL CREDITOR REQUIRED FOR   COLLECTION AGENCIES Report. When error code 946 is returned   from File One






Connect API Passive Auth Error Codes

End Point Error
Code
HTTP
Status
Code
Error Message Cause
/v3/passive/user
/v3/passive/user/otp
/v3/passive/auth/{userToken}
/v3/passive/user/answers
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
/v3/passive/user/otp/resend}
/v3/passive/auth/otp/resend/{userToken}}
1001 500 Internal error. {details} API. Any Exception that does not match any of the other exceptions
/v3/passive/user
/v3/passive/user/otp
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
/v3/passive/user/otp/resend}
/v3/passive/auth/otp/resend/{userToken}}
1004 400 Invalid Request API. API request is not properly formed
/v3/passive/user/answers

1004 500 Invalid Request API. API request is not properly formed
/v3/passive/user/answers
/v3/passive/user/otp
/v3/passive/auth/answers/{userToken}
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/user/otp/resend}
/v3/passive/auth/otp/resend/{userToken}}
1010 500 User not found. Token: {0}, User ID: {1}, Company ID: {2} API. User not found in Oracle (using   User Token)
/v3/passive/user/otp
/v3/passive/user/answers
1999 422 Match on Alert List API. Consumer Alert Match in Reseller DB when getting questions
/v3/passive/user/answers
/v3/passive/user/otp
/v3/passive/auth/answers/{userToken}
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/user/otp/resend}
/v3/passive/auth/otp/resend/{userToken}}
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/passive/user
/v3/passive/auth/{userToken}
/v3/passive/user/otp/resend}
/v3/passive/auth/otp/resend/{userToken}}
2502 401 Auth General Error. PID Error Code: {0}   PID. if PID error code in (313, 323, 720)
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2002 400 Invalid Parameter. PID Error Code: {0}  PID. if PID error code = 708
/v3/passive/user
/v3/passive/auth/{userToken}
2010 422 Minor Consumer PID. PID error code = 10
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2013 400 Format Error PID. PID error code = 13
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2018 422 Reported as Fraud PID. PID error code = 18
/v3/passive/user 2045 400 Invalid Surname PID. PID error code = 45 or 106
/v3/passive/user 2049 400 Invalid Zipcode PID. PID error code = 49
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2092 400 State legislation requires match on more identification information PID. PID error code = 92
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2403 400 SSN Required PID. PID error code = 403
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2404 400 Generation Code Required PID. PID error code = 404
/v3/passive/user 2405 400 Year of Birth Required PID. PID error code = 405
/v3/passive/user 2406 400 Middle Name Required PID. PID error code = 406
/v3/passive/user 2407 400 Unable to Standardize Address PID. PID error code = 407
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2500 504 Authentication Session Expired PID. PID Session Timeout
PID Service Timeout
PID error code = 710
/v3/passive/user
/v3/passive/user/answers
/v3/passive/auth/answers/{userToken}
2501 422 Exceeded limit of Authentication   attempted PID. No questions returned due to   excessive use (KBAResultCode=2)
/v3/passive/user/answers
/v3/passive/auth/answers/{userToken}
2502 401 Failed Authentication. PID Error Code: {0} PID. PID Incorrect answers
/v3/passive/user
/v3/passive/user/otp
/v3/passive/auth/{userToken}
/v3/passive/auth/answers/{userToken}
/v3/passive/auth/otp/{userToken}
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 (7, 8)
/v3/passive/user
2627 400 Invalid Street Address PID. PID error code = 627

/v3/passive/user
2633 400 Address Exceeds Max Length PID. PID error code = 633

/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2711 400 End user required PID. PID error code = 711

/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
2709 400 Invalid UserId or Password PID. PID error code = 709
/v3/passive/user
/v3/passive/user/otp
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
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/passive/auth/{userToken}
/v3/passive/user/otp
/v3/passive/user/answers
3002 401 User is already verified API. User is already PID   authenticaded
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
3009 504 Your identity verification   session has expired. PID. PID session is not valid
/v3/passive/user
/v3/passive/user/otp
/v3/passive/auth/{userToken}
/v3/passive/auth/answers/{userToken}
/v3/passive/auth/otp/{userToken}
3012 500 Unable to retrieve identity   questions. Please verify your information and try again API. Subcode not found (in SSO configuration)
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
3015 422 Authentication Failed P4C authyentication failed. Check the provided consumer information.
/v3/passive/user
/v3/passive/user/otp
/v3/passive/user/answers
/v3/passive/auth/{userToken}
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
3901 422 Consumer reported as deceased PID. Consumer deceased (PID   Score = 9001)
/v3/passive/user
/v3/passive/user/otp
/v3/passive/auth/{userToken}
/v3/passive/user/answers
/v3/passive/auth/otp/{userToken}
/v3/passive/auth/answers/{userToken}
7001 401 Unauthorized Request   API. When SSO user is not provided

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


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