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 processed00
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
SUCCESSOrder has completed processing, and credit data is viewable through the GraphQL API30
COMPLETEDOrder was successfully fulfilled from the credit data provider, but the PII provided for the requested consumer was not able to match any credit data with the consumer31
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 request10
11
12
13
CANCELEDOrder processing was cancelled50
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 API60
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.