Get a consumer's vantage3 credit score

get https://sandbox.bloom.dev/{version}/consumers/{consumer_id}/credit.bloom.score.vantage3/{order_id}

Get a consumer's Vantage 3.0 credit score.

Sandbox Data

When using this endpoint in the Sandbox, you can request a specific set of data by registering and requesting data for a consumer with a specific Social Security number. In this case, the trigger for specific data is the 2nd digit of the Sandbox consumer's SSN. There are 5 deterministic responses, each corresponding to an SSN with 2nd digit: 0, 1, 2, 3 and 4. If the 2nd digit of the consumer's SSN is not in this set, the data returned will be random.

For example, you can register a Sandbox consumer with the SSN: 909-99-9999. Then, when requesting their credit.bloom.score.vantage3, the following data will always be returned for that consumer:

{
  "data": {
    "type": "credit.bloom.score.vantage3",
    "attributes": {
      "model": {
        "source": "equifax",
        "identifier": "05143",
        "descriptor": "",
        "indicator": ""
      },
      "reasons": [
        {
          "code": "01",
          "narrative": "Amount owed on accounts is too high"
        }
        
      ],
      "value": 555,
    }
  }
}

you could have registered the consumer with an SSN of 808-88-8888 or 001-23-4567. As long as the 2nd digit of their SSN is 0 (i.e. the SSN is of the form: X0X-XX-XXXX) you can be certain the above data will always be returned.

See the examples below for all the possible responses that correspond with the 2nd digit of a Sandbox consumer's SSN.

This endpoint will return upto 4 reason codes for the score that was returned.

Following are the possible reason codes that can be returned:

Reason Code	Description
04	The balances on your accounts are too high compared to loan amounts
05	Too many of the delinquencies on your accounts are recent
06	You have too many accounts that were opened recently
07	You have too many delinquent or derogatory accounts
08	You have either very few loans or too many loans with recent delinquencies
09	The worst payment status on your accounts is delinquent or derogatory
10	You have either very few loans or too many loans with delinquencies
11	The total of your delinquent or derogatory account balances is too high
12	The date that you opened your oldest account is too recent
13	Your most recently opened account is too new
14	Lack of sufficient credit history
15	Newest delinquent or derogatory payment status on your accounts is too recent
16	The total of all balances on your open accounts is too high
17	Balances on previously delinquent accounts are too high compared to loan amts
18	Total of balances on accounts never late is too high compared to loan amounts
21	No open accounts in your credit file
22	No recently reported account information
23	Lack of sufficient relevant account information
29	Too many of your open bankcard or revolving accounts have a balance
30	Too few of your bankcard or other revolving accounts have high limits
31	Too many bankcard or other revolving accounts were opened recently
32	Balances on bankcard or revolving accounts too high compared to credit limits
33	Your worst bankcard or revolving account status is delinquent or derogatory
34	Total of all balances on bankcard or revolving accounts is too high
35	Your highest bankcard or revolving account balance is too high
36	Your largest credit limit on open bankcard or revolving accounts is too low
39	Available credit on your open bankcard or revolving accounts is too low
40	The date you opened your oldest bankcard or revolving account is too recent
42	The date you opened your newest bankcard or revolving account is too recent
43	Lack of sufficient credit history on bankcard or revolving accounts
44	Too many bankcard or revolving accounts with delinquent or derogatory status
45	Total balances too high on delinquent/derogatory bankcard or revolving accts
47	No open bankcard or revolving accounts in your credit file
48	No bankcard or revolving recently reported account information
49	Lack of sufficient relevant bankcard or revolving account information
53	The worst status on your real estate accounts is delinquent or derogatory
54	The amount of balance paid down on your open real estate accounts is too low
55	Open real estate account balances are too high compared to their loan amounts
44	Too many bankcard or revolving accounts with delinquent or derogatory status
45	Total balances too high on delinquent/derogatory bankcard or revolving accts
47	No open bankcard or revolving accounts in your credit file
48	No bankcard or revolving recently reported account information
49	Lack of sufficient relevant bankcard or revolving account information
53	The worst status on your real estate accounts is delinquent or derogatory
54	The amount of balance paid down on your open real estate accounts is too low
55	Open real estate account balances are too high compared to their loan amounts
57	Too many real estate accounts with delinquent or derogatory payment status
58	The total of all balances on your open real estate accounts is too high
61	No open real estate accounts in your credit file
62	No recently reported real estate account information
63	Lack of sufficient relevant real estate account information
64	No open first mortgage accounts in your credit file
65	Lack of sufficient relevant first mortgage account information
66	Your open auto account balances are too high compared to their loan amounts
68	No open auto accounts in your credit file
69	Lack of sufficient relevant auto account information
71	You have either very few installment loans or too many with delinquencies
72	Too many installment accounts with a delinquent or derogatory payment status
73	The worst status on your installment accounts is delinquent or derogatory
74	The balance amount paid down on your open installment accounts is too low
75	The installment account that you opened most recently is too new
76	You have insufficient credit history on installment loans
77	Newest delinquent or derogatory status on installment accounts is too recent
78	Balances on installment accounts are too high compared to their loan amounts
79	Too many of the delinquencies on your installment accounts are recent
81	No open installment accounts in your credit file
83	Lack of sufficient relevant installment account information
84	The number of inquiries was also a factor, but effect was not significant
85	You have too many inquiries on your credit report.
86	Your credit report contains too many derogatory public records
87	Your credit report contains too many unsatisfied public records
88	One or more derogatory public records in your credit file is too recent
90	Too few discharged bankruptcies
93	The worst status on your student loan accounts is delinquent or derogatory
94	The balance amount paid down on your open student loan accounts is too low
95	You have too many collection agency accounts that are unpaid
96	The total you owe on collection agency accounts is high
97	You have too few credit accounts
98	There is a bankruptcy on your credit report

the identifier will always be "05143"