Debt Profile Statuses

On the User Response, Spinwheel is returning creditReport.connectionStatus.dataStatus to indicate the status of a user. Below are the expected responses for each use case:

📘

Refreshing a User

Each user will need to have a '2000' statusCode in order to successfully refresh.

Code variation by Bureau

Different bureaus treat certain user report statuses differently. Given this, the following is what you would see broken out by the credit bureau associated with a given user.

Equifax

statusCodedataStatus.DataStatusEnumdescription
2000COMPLETEDAuthentication is successful.
2001IN_PROGRESSAuthentication is in progress.
5000ERRORAuthentication failed.
5000ERRORAuthentication is successful. (Credit report request or process failed)
5000ERRORFraudulent credit report detected.
5000ERRORFrozen credit report detected.
5000ERRORConsumer-locked credit report.
5000ERRORUnknown Error.
4000ERRORCredit report is only available for manual return.
4000ERRORManual review required due to delivery issues or fraud alerts.
4090ERRORFile is under review or being referred to another department.
4040ERRORCredit report not found.
{ dataStatus: DataStatusEnum.COMPLETED, description: 'Authentication is successful.', statusCode: 2000 }
{ dataStatus: DataStatusEnum.IN_PROGRESS, description: 'Authentication is in progress.', statusCode: 2001 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Authentication failed.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Authentication is successful.', statusCode: 5000 } // Credit report request or process failed
{ dataStatus: DataStatusEnum.ERROR, description: 'Fraudulent credit report detected', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Frozen credit report detected.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Consumer-locked credit report.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Unknown Error.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Credit report is only available for manual return.', statusCode: 4000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Manual review required due to delivery issues or fraud alerts.', statusCode: 4000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'File is under review or being referred to another department.', statusCode: 4090 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Credit report not found.', statusCode: 4040 }

TransUnion

statusCodedataStatus.DataStatusEnumdescription
2000COMPLETEDAuthentication is successful.
2001IN_PROGRESSAuthentication is in progress.
5000ERRORAuthentication failed.
5000ERRORAuthentication is successful. (Credit report request or process failed)
2000COMPLETEDFraudulent credit report detected.
2000COMPLETEDFrozen credit report detected.
5000ERRORConsumer-locked credit report.
5000ERRORUnknown Error.
4000ERRORCredit report is only available for manual return.
4000ERRORManual review required due to delivery issues or fraud alerts.
4090ERRORFile is under review or being referred to another department.
4040ERRORCredit report not found.

{ dataStatus: DataStatusEnum.COMPLETED, description: 'Authentication is successful.', statusCode: 2000 }
{ dataStatus: DataStatusEnum.IN_PROGRESS, description: 'Authentication is in progress.', statusCode: 2001 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Authentication failed.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Authentication is successful.', statusCode: 5000 } // Credit report request or process failed
{ dataStatus: DataStatusEnum.COMPLETED, description: 'Fraudulent credit report detected', statusCode: 2000 }
{ dataStatus: DataStatusEnum.COMPLETED, description: 'Frozen credit report detected.', statusCode: 2000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Consumer-locked credit report.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Unknown Error.', statusCode: 5000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Credit report is only available for manual return.', statusCode: 4000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Manual review required due to delivery issues or fraud alerts.', statusCode: 4000 }
{ dataStatus: DataStatusEnum.ERROR, description: 'File is under review or being referred to another department.', statusCode: 4090 }
{ dataStatus: DataStatusEnum.ERROR, description: 'Credit report not found.', statusCode: 4040 }