Credit Data Orders

Retrieving Credit Data for Consumers from Bloom's Data Access API

Order States

StateDescriptionCodesTerminal?
PENDINGInitial state for all orders, waiting to be processed.00
INGESTEDOrder is currently being routed to the bureau data provider(s).20
PROCESSINGOrder is in processing if it's being:

1. Retrieved from the bureau
2. Encrypted and stored on Bloom's systems
3. Parsed and converted for our API presentation layer
21
22
SUCCESSThe order was successfully submitted and processed by the credit data provider. Successful orders could result in Hits, where the data is made available for querying via our GraphQL API; or could result in a condition where the bureau does not return a credit report (No-hit, Frozen/Blocked, or consumer is under 18) and no data is available to be queried.30
31
32
33
FAILEDOrder has failed to process, which can include any of the reasons below:

1. Bureau was unresponsive or had API errors.
2. Bloom had internal errors when processing the order.
40
41
42
43
REJECTEDOrder was rejected from being processed by Bloom due to some malformed client request.10
11
12
13
CANCELEDOrder processing was cancelled.50
51
DELETED_RETENTIONPreviously submitted order has been deleted due to retention rules and credit data is erased from Bloom's systems, no longer viewable from the API.60
61
62

Code Details

00

The order request was accepted, and is waiting to be processed.


10

The order is was rejected because the provided SKU is not enabled.


11

The order is was rejected because the provided consumer ID is not valid or does not exists.


12

The order is was rejected because the provided portfolio ID is not valid or does not exists.


13

The order is was rejected because the provided consumer age is under 18 years old.


20

The order request is queued for processing.


21

The bureau is being queried to retrieve the credit data.


22

The credit data is being parsed from the bureau.


30

The request was completed and the bureau returned a Hit.


31

The bureau was not able to access the requested consumer's credit report due to a Frozen or blocked file.


32

The bureau was not able to match the requested consumer with any credit report, returning a No-Hit status


33

The request was completed using a partially created consumer without a date of birth, but the bureau detected that the requested consumer age is under 18 years old.


40

The request failed due to a Bureau validation error


41

The request failed due to a Bureau availability error. The max number of retries was reached.


42

The request failed due to a Bureau system error.


43

The request failed due to a Bloom system error.


50

The request was canceled by client.


51

The request was canceled by Bloom.


60

Data retention threshold reached.


61

Data deleted at consumer’s request.


62

Data deleted at client’s request.


99

The request sent is malformed, or some of the informed fields didn't pass our service validations.

Make sure the values sent are matching the correct type defined in the specification. More details will be provided directly in the response you get.