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.
This operation lets you order credit reports for multiple customers. You specify the customers and the type of credit report for each through an unnamed array of objects in the request body. For example:
[
{
"clientKey": "abcd-1234-defgh-5678",
"productCode": "exp1bScore"
},
{
"clientKey": "ijkl-9012-mnop-3456",
"productCode": "tui1bReportScore"
},
{
"clientKey": "qrst-7890-uvwx-1234",
"productCode": "credmo3bReportScore"
}
]
There's no internal restriction on the number of elements in the array; it has successfully fulfilled 500+ orders at a time.
The response body returns your array with some additional properties:
[
{
"clientKey": "abcd-1234-defgh-5678",
"productCode": "exp1bScore",
"error": 0,
"displayToken": "2148251b-fa9d-4e5e-bf2a-ac30f7d42f8c",
"reportKey": "2fcba257-2d08-4c69-92a7-870682e5daed"
},
{
"clientKey": "ijkl-9012-mnop-3456",
"productCode": "tui1bReportScore",
"error": 401,
"displayToken": null,
"reportKey": null
},
{
"clientKey": "qrst-7890-uvwx-1234",
"productCode": "credmo3bReportScore",
"error": 0,
"displayToken": "c23840a0-2c43-4370-b159-6582571275aa",
"reportKey": "6c30d771-2328-4095-9550-7ee5ced215ed"
}
]
The error
property is the focal point of an entry in the response array:
-
If
error
is0
, the report order was successfully fulfilled. ThedisplayToken
andreportKey
properties are populated with values that you'll use when you retrieve the report. -
Any other
error
value means the report order wasn't fulfilled and can't be retrieved. The values themselves (400
,401
,403
, and so on) mimic the HTTP status values for the Order a Credit Report operation. For example, in the snippet above, the"error": 401
entry means that the customer identified byijkl-9012-mnop-3456
hasn't been authenticated.
The fulfilled credit reports must be retrieved individually through repeated calls to Retrieve a Credit Report.
NOTE This operation may only be called from your server. It can't be called from a customer's device.