User Connection Status Codes

Connection Status Code Matrix

📘
Note:
isValid flag on the connectionStatus is a great reference point for the validity of the user's credentials

Status Code	isValid	HTTP Status Code	Description	Webhook fired	Notes
2000	TRUE	200	Auth successful!	TRUE
2001	FALSE	200	Security step pending.	TRUE
2003	FALSE	200	Email missing on user's profile.	TRUE	We are not able to get all of the loan account information if the email has not been provided to the servicer.
2004	FALSE	200	Need to confirm auto-debit enrollment.	TRUE	Without confirming/denying auto-debit info, we are not able to get account information.
2005	TRUE	200	Auth successful!	FALSE	The user selected an incorrect servicer during the initial connection.
2006	TRUE	200	Servicer specific status where authentication is stuck for any other reason	FALSE (note: webhook will be fired for existing connections)	The messaging will vary by loan servicer.
5000	TRUE	500	{{Error is passed directly from the servicer}}	FALSE
5001	FALSE	401	{{Error is passed directly from the servicer}}	TRUE
5002	FALSE	401	{{Error is passed directly from the servicer}}	TRUE
5003	TRUE	401	{{Error is passed directly from the servicer}}	FALSE
5004	FALSE	401	{{Error is passed directly from the servicer}}	TRUE

To learn more about our debt APIs and 1-click solutions, visit spinwheel.io.