TransUnion information may not be transmitted by Array to Array clients or third parties, nor may Array clients access, view, share, process, or store TransUnion information.
Retrieving a customer's credit report is a two-step process:
-
First, you submit an order for the report -- that's what this operation is for. To order a report, you must supply the
clientKey
of an authenticated customer, and aproductCode
that denotes the type of report you want to order. TheproductCode
the values and definitions are listed later in this overview. -
If the operation is successful, you'll receive a
reportKey
token and adisplayToken
token that you pass to Retrieve a Credit Report which assembles and returns the credit report information in one of a number of different formats -- JSON, XML, HTML, and so on. The tokens are good for one retrieval, only.
In most client agreements, the customer gets a free credit report per billing cycle (or other time allotment). Ordering an additional report within the cycle creates a billing event, but doesn't reset the "free report clock".
Other ways to order a report
This operation orders a report for a single customer. If you want to order credit reports for multiple customers in a single call, see the Order Credit Reports for Multiple Customers operation.
The data that this operation orders is current as of the time that the operation is invoked. If you want to order a report whose data is updated when the report is retrieved, use the Order Virtual Report operation.
Product codes
The values you can pass as the productCode
property are listed below. Not all product codes are available to all apps.
Code | Meaning |
---|---|
quickView | An abbreviated version of the credit report that contains only essential information. |
tui1bReport | Credit report from TransUnion. |
tui1bScore | Credit score from TransUnion. |
tui1bReportScore | Credit report and score from TransUnion. |
exp1bScore | Credit Score from Experian. |
exp1bReportScore | Credit report and score from Experian. |
efx1bScore | Credit score from Equifax. |
efx1bReportScore | Credit report and score from Equifax. |
credmo3bReportScore | A merge of the reports and scores from all three bureaus. |
credmo2bReportScoreTuiEfx | A merge of the reports and scores from TransUnion and Equifax. |
credmo2bReportScoreTuiExp | A merge of the credit reports and scores from TransUnion and Experian. |
credmo2bReportScoreEfxExp | A merge of the credit reports and scores from Equifax and Experian. |