Sandbox Identities
Back to array.com
Array provides a number of fictitious customer identities that you can use when you're testing your application. While these identities don't map to actual people, they're not entirely fake: They're created by the "authentication providers" (currently, the credit bureaus). This means that...
-
When you authenticate a sandbox identity, the personally-identifying questions are retrieved from and verified by an actual authentication provider.
-
When you retrieve a credit report for a sandbox identity, you're retrieving real credit report data from a credit bureau -- you're not getting a canned response from Array.
Creating and Authenticating a Sandbox User
In order to use a sandbox identity you must:
-
Create a User object based on the PII listed in the Identity Information section of this document.
-
Authenticate the User by invoking Retrieve Authentication Questions followed by Answer Authentication Questions.
See How to Retrieve a Credit Report for a tutorial that steps you through the process of creating and authenticating a sandbox identity (with the ultimate goal of retrieving a credit report).
Authenticating a sandbox identity isn't a billable event.
Authentication Answers
During the authentication process, you must answer a set of personally-identifying questions. How you determine the correct answers depends on the bureau that has supplied the questions.
TransUnion and Experian
The correct answers to questions that are provided by TransUnion or Experian are listed below. If one of these answers is offered, choose it, otherwise choose "None of the above" or similar evasive reply.
- $200 - $249
- $385 - $484
- 2021
- 5518
- 7515
- Ashwood
- ASI Medical
- Bechtelcon
- Bethel
- BMW X5
- Ford F100 Pickup
- Carroll County Bank &
- Dentist / Dental Hygienist
- Dr Ralph Alperin MD
- Dr Ira Adler
- Great Financial SVC
- Histo Tec Laboratory
- IEC
- KIA Sorento
- Lynn Lee Const Co In
- Maggies Flowers & Gift
- Morrison Mahoney Miller
- New Hampshire
- Sallie Mae Servicing
- SN Katz Jewelry
- The Toronto-Dominion Bank
- Toyota Highlander
- Tuscaloosa
- Volkswagen Passat
- Wells Fargo & Company
Experian often asks questions that aren't applicable to the sandbox identity that you're attempting to authenticate, which forces you to provide "None of the above" answers. If you provide too many such answers (where "too many" depends on the identity), you'll be presented with more questions, and again more if necessary. You should keep answering the new questions until the authentication either succeeds or fails. If it fails, try the entire process again.
Equifax
When Equifax provides questions for a sandbox identity, it includes a correctAnswer
property in the response to the Retrieve Authentication Questions operation. Each answer object in the response sets the value of the property to "true"
or "false"
(note that the value is a string, not a Boolean). For example:
{
"authToken": "6011DADC-6B2A-43BA-B750-0EA5F2F69372",
"provider": "efx",
"questions": [
{
"id": "1",
"text": "Your credit file indicates you may have a bank card, opened in or around April 2016. Who is the credit provider for this account?",
"answers": [
{
"id": "1",
"text": "CITIGROUP INC.",
"correctAnswer": "true"
},
{
"id": "2",
"text": "JP MORGAN CHASE & CO",
"correctAnswer": "false"
},
{
"id": "3",
"text": "STATE FARM",
"correctAnswer": "false"
},
{
"id": "4",
"text": "THE PNC FINANCIAL SERVICES GROUP INC",
"correctAnswer": "false"
},
{
"id": "5",
"text": "NONE OF THE ABOVE",
"correctAnswer": "false"
}
]
},
...
In this snippet, the answer to question 1 ("id": "1"
) is "CITIGROUP INC." (also "id": "1"
).
Bureau Grid
The table below indicates the bureaus that can generate a credit report for each identity, and the system that the bureau uses to generate a credit score for that identity. The scoring system value is in the form "VSN" for VantageScore version N, or "FN" for FICO version N.
When you authenticate a sandbox identity, you should specify, as authentication providers, all of the bureaus that are listed in the grid for that identity. For example, you would specify all three bureaus for a three-report identity such as Thomas Devos, even if you only want an Experian report. For Banker Coldiron, you can specify Equifax, only.
In order to retrieve a FICO-scored report, your application must be "FICO enabled". Talk to your Array Support Representative for more information.
Equifax | Experian | TransUnion (VantageScore) | TransUnion (FICO) | |
---|---|---|---|---|
Banker Coldiron | ✅ | - | - | - |
Carletta Fzldx | ✅ | - | - | - |
Carmen Balakhanpour | ✅ | - | - | - |
Dalton Lot | - | - | ✅ | - |
Denise Hennessy | ✅ | ✅ | - | - |
Donald Blair | ✅ | ✅ | ✅ | - |
Donna Kohler | ✅ | - | - | - |
Fredrick Bueche | ✅ | - | ✅ | - |
Gertrude Harkenreadeo | ✅ | - | ✅ | - |
James Holloway | - | - | - | ✅ |
Jennifer Sprier | - | - | - | ✅ |
Kimberly Olstrup | - | - | ✅ | - |
Maria Iglesias | ✅ | ✅ | - | - |
Nadine Bellavia | ✅ | ✅ | - | - |
Robert Davis | - | - | - | ✅ |
Ronald Cozzi | ✅ | - | - | - |
Thomas Devos | ✅ | ✅ | ✅ | - |
Thomas Friedman | - | - | ✅ | - |
Tippy Dowell | - | - | - | ✅ |
Vincent Behill | ✅ | ✅ | ✅ | - |
Identity Information
The sandbox identities are described by the JSON objects in the following sections. To create a User object for an identity, copy the object, replace <yourAppKey>
with your actual app key, and then pass the object as the request body of a Create a User call.
Banker Coldiron
Bureaus: Equifax (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "BANKER",
"lastName": "COLDIRON",
"dob": "1974-04-18",
"ssn": "666230560",
"address": {
"street": "3390 WESTERN AV",
"city": "GRAND PRAIRIE",
"state": "TX",
"zip": "75052"
}
}
Carletta Fzldx
Bureaus: Equifax (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "CARLETTA",
"lastName": "FZLDX",
"dob": "1995-12-28",
"ssn": "666677368",
"address": {
"street": "530 ANTWERP AVE",
"city": "BIRMINGHAM",
"state": "AL",
"zip": "35212"
}
}
Carmen Balakhanpour
Bureaus: Equifax (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "CARMEN",
"lastName": "BALAKHANPOUR",
"dob": "1966-11-02",
"ssn": "666700239",
"address": {
"street": "805 S MAPLEWOOD AV",
"city": "NIAGARA FALLS",
"state": "NY",
"zip": "14301"
}
}
Dalton Lot
Bureaus: TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "DALTON",
"lastName": "LOT",
"dob": "1955-01-01",
"ssn": "666603445",
"address": {
"state": "OH",
"street": "758 E 103RD ST",
"city": "CLEVELAND",
"zip": "44108"
}
}
Denise Hennessy
Bureaus: Equifax (VantageScore), Experian (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "DENISE",
"lastName": "HENNESSY",
"dob": "1967-03-05",
"ssn": "666662921",
"address": {
"street": "80 GRASSY PLAIN ST",
"city": "BETHEL",
"state": "CT",
"zip": "06801"
}
}
Donald Blair
Bureaus: Equifax (VantageScore), Experian (VantageScore), TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "DONALD",
"lastName": "BLAIR",
"dob": "1939-09-20",
"ssn": "666285344",
"address": {
"street": "3627 W POPLAR ST",
"city": "SAN ANTONIO",
"state": "TX",
"zip": "78228"
}
}
Donna Kohler
Bureaus: Equifax (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "DONNA",
"lastName": "KOHLER",
"dob": "1930-01-01",
"ssn": "666640946",
"address": {
"street": "5505 24TH AVE",
"city": "SEATTLE",
"state": "WA",
"zip": "98107"
}
}
Fredrick Bueche
Bureaus: Equifax (VantageScore), TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "FREDRICK",
"lastName": "BUECHE",
"dob": "1965-09-26",
"ssn": "666112768",
"address": {
"street": "17 E MT ROYAL AVE",
"city": "BALTIMORE",
"state": "MD",
"zip": "21202"
}
}
Gertrude Harkenreadeo
Bureaus: Equifax (VantageScore), TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "GERTRUDE",
"lastName": "HARKENREADEO",
"dob": "1967-06-08",
"ssn": "666066112",
"address": {
"street": "305 LINDEN AV",
"city": "ATLANTA",
"state": "GA",
"zip": "30316"
}
}
James Holloway
Bureaus: TransUnion (FICO)
{
"appKey": "<yourAppKey>",
"firstName": "JAMES",
"lastName": "HOLLOWAY",
"ssn": "666600312",
"dob": "1962-07-01",
"address": {
"state": "MO",
"city": "EUREKA",
"street": "192 HUNTERS GREEN LN",
"zip": "63025"
}
}
Jennifer Sprier
Bureaus: TransUnion (FICO)
{
"appKey": "<yourAppKey>",
"firstName": "JENNIFER",
"lastName": "SPRIER",
"dob": "1976-07-01",
"ssn": "666688538",
"address": {
"street": "1601 BROWN ST",
"city": "ABILINE",
"state": "KS",
"zip": "67410"
}
}
Kimberly Olstrup
Bureaus: TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "KIMBERLY",
"lastName": "OLSTRUP",
"dob": "1947-01-01",
"ssn": "666561858",
"address": {
"street": "125 W 100 N",
"city": "JEROME",
"state": "ID",
"zip": "83338"
}
}
Maria Iglesias
Bureaus: Equifax (VantageScore), Experian (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "MARIA",
"lastName": "IGLESIAS",
"dob": "1958-12-28",
"ssn": "666824123",
"address": {
"street": "21 PACIFIC ST",
"city": "PITTSFIELD",
"state": "MA",
"zip": "01201"
}
}
Nadine Bellavia
Bureaus: Equifax (VantageScore), Experian (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "NADINE",
"lastName": "BELLAVIA",
"dob": "1947-05-19",
"ssn": "666572501",
"address": {
"street": "4037 SENOUR RD",
"city": "INDIANAPOLIS",
"state": "IN",
"zip": "46239"
}
}
Robert Davis
Bureaus: TransUnion (FICO)
{
"appKey": "<yourAppKey>",
"firstName": "ROBERT",
"lastName": "DAVIS",
"dob": "1970-07-01",
"ssn": "666816516",
"address": {
"street": "2317 WEXFORD RD",
"city": "LATHROP",
"state": "MO",
"zip": "64465"
}
}
Ronald Cozzi
Bureaus: Equifax (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "RONALD",
"lastName": "COZZI",
"dob": "1975-03-19",
"ssn": "666656704",
"address": {
"street": "53 W JACKSON BV",
"city": "HIALEAH",
"state": "FL",
"zip": "33012"
}
}
Thomas Devos
Bureaus: Equifax (VantageScore), Experian (VantageScore), TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "THOMAS",
"lastName": "DEVOS",
"dob": "1957-09-06",
"ssn": "666023511",
"address": {
"street": "1206 BEAR CREEK RD APT 110",
"city": "TUSCALOOSA",
"state": "AL",
"zip": "35405"
}
}
Thomas Friedman
Bureaus: TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "THOMAS",
"lastName": "FRIEDMAN",
"dob": "1975-01-01",
"ssn": "666234390",
"address": {
"state": "CO",
"street": "535 30 RD A",
"city": "GRAND JUNCTION",
"zip": "81504"
}
}
Tippy Dowell
Bureaus: TransUnion (FICO)
{
"appKey": "<yourAppKey>",
"firstName": "TIPPY",
"lastName": "DOWELL",
"dob": "1955-07-01",
"ssn": "666364030",
"address": {
"street": "1229 BLUESTONE TE",
"city": "SAINT LOUIS",
"state": "MO",
"zip": "63119"
}
}
Vincent Behill
Bureaus: Equifax (VantageScore), Experian (VantageScore), TransUnion (VantageScore)
{
"appKey": "<yourAppKey>",
"firstName": "VINCENT",
"lastName": "BEHILL",
"dob": "1947-05-19",
"ssn": "666506100",
"address": {
"street": "909 HAVERHILL DR",
"city": "HARLEM",
"state": "GA",
"zip": "30814"
}
}
Updated 21 days ago