Using Multi-Bureau Support
Overview
Credit bureaus go down. Data feeds lag. Formats change without warning. When your credit infrastructure depends on a single bureau, any one of these becomes your outage.
Spinwheel’s multi-bureau endpoint gives you credit reports and scores backed by multiple bureaus, with automatic failover built in. If your primary source has an issue, Spinwheel routes around it — no code changes, no downtime, no explaining to your users why the report didn't come through.
Today, we support both TransUnion and Equifax. The Debt Profile endpoint (/v1/users/USERID/debtProfile) gives you access to credit reports and scores from multiple bureaus with automatic failover when approved.
How to Use the Multi-Bureau Endpoint
Choose Your Bureau Strategy
-
Let Spinwheel handle failover:
Omit thesourceBureauin your request. Spinwheel will use your default bureau, and in the rare event of an outage, it will failover to a secondary bureau. We’ll assist you with the default bureau configuration during onboarding. If you need to update it later, please reach out to our support team. -
Manually control bureau selection:
Explicitly setsourceBureauparameter to the bureau of your choice. This gives you full control, however, it also prevents automatic failover during credit bureau outages.
Notes on refreshing:
- Refresh requests must use the bureau the user was originally connected with.
- If you don’t provide a bureau explicitly, Spinwheel will handle it automatically and send the request to your configured default bureau.
- For repetitive refreshes in general, subscriptions are recommended to ensure ongoing updates across bureaus.
Build Your Request
You may request both a credit report and a credit score in the same call, or only one of them.
- To request both, include both
creditReportandcreditScoreobjects. - To request only one, simply omit the other object from the request body.
Example Request - Report and Score
POST /v1/users/USERID/debtProfile
{
"creditReport": {
"sourceBureau": "TransUnion",
"type": "1_BUREAU.FULL"
},
"creditScore": {
"sourceBureau": "TransUnion",
"model": "VANTAGE_SCORE_3_0"
}
}Example Request - Only a Score
POST /v1/users/USERID/debtProfile
{
"creditScore": {
"sourceBureau": "TransUnion",
"model": "VANTAGE_SCORE_3_0"
}
}
A few constraints:
- FICO® scores require separate approval and are only available through TransUnion. Talk to your Spinwheel Customer Success Manager to get enabled before requesting one.
- Future refresh requests must use the bureau the user was originally connected with.
Secure Data
As always, if you would like to order or access unmasked account numbers or other secure data please make sure to use the secure endpoint.
Don't have permissions to use the secure endpoint? Please contact your Spinwheel Customer Success representative for more information, requirements, and access permissions.
Updated 8 days ago

