2nd Look Marketplace (Financial Services Providers)

API BUILD GUIDANCE

As the leading search, comparison and recommendation engine for financial services, Engine by MoneyLion powers the largest network of connected premium Financial Institutions and channels. With over 50 Institutions offering unsecured loans, secured loans, lines of credit, debt consolidation, debt repair etc., Engine by MoneyLion specializes in matching consumers with personalized offers that fit their specific needs.

Through Engine by MoneyLion’s 2nd Look offering, we’re presenting partners the opportunity to offer financial products to consumers who were not preapproved for a loan offer. In introducing our 2nd Look Marketplace, we’re giving you the power to determine the value of a consumer and bid for them at a rate that works for your business model.

Platform Flow

In the diagram below we review how our platform will function once the 2nd Look Marketplace is launched. Steps 1-4 mirror our existing 1st Look workflow and functionality. Steps 5 and 6 introduce the new marketplace capabilities.

In the first phase of the 2nd Look Marketplace, we will display your offer if it is the highest bid returned for the lead. In the second phase, we will display it if it is the highest bid for that specific product type (installment loans, debt relief, etc.).

You will only need to pay Engine by MoneyLion as according to your contract (typically either on click, or on conversion)

Workflow Steps

  1. A lead submits a common loan application.

  2. Applicant’s details are sent to our 1st Look partners.

  3. The 1st Look partners do not return any offers.

  4. Applicant’s details are sent to our 2nd Look partners.

  5. Offers (and their respective recommendation scores) are returned.

  6. Displays offers with highest recommendation score per productSubType.

  • Each product type (installment loan, credit builder, etc.) will have one winner determined by the highest recommendationScore. For example, we will show one debt relief offer, one installment loan offer, etc.

Terms & Conditions

  • The 2nd Look partner only pay Engine by MoneyLion based on the terms of the contract (either click or conversion).

  • The 2nd Look partner must not remarket to any lead that DOES NOT click on their offer.

  • The lead application data sent to the 2nd Look partner can be anything from our lead specification (see Appendix).

  • If the 2nd Look partner’s API does not respond within the recommended response window (12 seconds), the offer may be disregarded.

Request Structure

Some fields in the request will always be present in 2L calls (for supply partners hitting direct to 2L) while some is only sometimes present in 2L calls (for partners hitting 1L/2L waterfall). Below is a quick overview of the data available to be sent to Financial Institution partners for 2nd Look Marketplace.

Available data for 2LM Financial Partners

Field
Type
Always Available? (Yes, No, Conditional)
Sample Value
Enum/Comment

personalInformation

Object

Y

|--firstName

String

Y

John

|--lastName

String

Y

Doe

|--email

String

Y

|--city

String

Y

New York

City

|--state

String

Y

NY

State 50 U.S. states + DC (District of Columbia) + PR (Puerto Rico) + VI (U.S. Virgin Islands)

|--primaryPhone

String

Y

2125556789

Phone number.

|--address1

String

Y

45 West 21st Street

|--address2

String

N

5th Floor

|--zipcode

String

Y

10010

|--dateOfBirth

String

Y

1993-10-09

yyyy-mm-dd

|--ssn

String

Y

111-22-3333

Social Security Number

loanInformation

Object

Y

|--purpose

String

Y

debt_consolidation

See enum at API reference - purpose

|--loanAmount

Number

N

1000

Unit in USD

mortgageInformation

Object

N

|--propertyStatus

String

N

rent

See enum at API reference - propertyStatus

creditInformation

Object

Y

|--providedCreditRating

String

Conditional

good

Either providedCreditRating or providedNumericCreditScore will be available

|--providedNumericCreditScore

Number

Conditional

730

financialInformation

Object

|--employmentStatus

String

N

employed

See enum at API reference - employmentStatus

|--employmentPayFrequency

String

N

weekly

See enum at API reference - employmentPayFrequency

|--annualIncome

Number

C

100000

Either annualIncome or monthlyNetIncome must be present. Unit in USD

|--monthlyNetIncome

Number

C

5000

Unit in USD

legalInformation

Object

Y

|--consentsToFcra

String

Y

true

Consents to FCRA

|--fcraLanguage

String

Y

"By checking this box/clicking 'agree' I hereby consent to ..."

|--consentstoTcpa

String

N

true

Consents to FCRA

|--tcpaLanguage

String

C

-

If consentstoTcpa is set to true, tcpaLanguage will be present

sessionInformation

Object

Y

|--ipAddress

String

Y

8.8.8.8

|--userAgent

String

Y

MyApp/2.1 (iOS 16.3; iPhone13,2)

This is the userAgent of the client (i.e., end consumer's device), which is different from the User-Agent in the request header, which is of Engine platform's server.

Approved Offers

Below are some directional examples of how your API can interact with Engine by MoneyLion. In no way should this be viewed as a requirements document; it is meant to help you understand some frameworks of how the 2nd Look marketplace will work.

{
  "status": "approved",
  "lead_id": "123",
  "offers": [
    {
      "name": "Bank ABC",
      "display_name": "Bank ABC",
      "rate": 9.5,
      "click_url": "https://foo.com?approval_id=123",
      "offer_details": "Lorem ipsum",
      "product_type": "unsecured_loan",
      "logo_src": "https://www.yourcdn.com/logo/image1.png"
    },
    {
      "name": "Credit Builder 123",
      "display_name": "Best Credit Builder",
      "rate": 11.0,
      "click_url": "https://foo.com?approval_id=456",
      "offer_details": "Lorem ipsum",
      "product_type": "credit_builder",
      "logo_src": "https://www.bestcbCDN.com/logo/image1.png"
    },
    {
      "name": "Credit Repair for You",
      "display_name": "Fast Credit Repair",
      "rate": 6.0,
      "click_url": "https://foo.com?approval_id=789",
      "offer_details": "Lorem ipsum",
      "product_type": "credit_repair",
      "logo_src": "https://www.fastcreditpairCDN.com/logo/image1.png"
    }
  ]
}

Field

Required

Definition

status

yes

Passing if the lead has been approved, rejected or if there was an error

lead_id

yes

Values needed to create your click URLs or enable other reporting functionality as agreed on during integration evaluation

offers

name

no*

The name of your company

display_name

no*

The name you want displayed to the lead

rate

yes

The amount you will pay if your offer is clicked on by the lead

click_url

yes

The url to redirect the lead to upon click

offer_details

no*

Marketing text to be displayed with the offer to the lead

product_type**

no*

The type of service/product the lead is being shown (ex. Debt Consolidation)

logo_src

no*

The logo to be shown on the offer

* Required if your API will be returning multiple types of offers, or if you’d like dynamic control over offer presentation. Otherwise, you can work with our Partner Solutions team directly to populate these values manually.

** This information will enable Engine by MoneyLion to appropriately alert the lead of the type of offer they are being shown and provide any educational background needed. It will also enable us to provide you with robust reporting on product performance across all vendors in our marketplace.

Rejected Offers

This is how your platform can provide rejections:

{
  "status": "rejected",
  "lead_id": "456",
  "reason": "credit_score_low"
}

Note: the reason field should include any strings that help us better understand why a lead was rejected and will be in our optimizations and reporting.

Errors

This is how your platform can provide error responses:

{
  "status": "error",
  "lead_id": "789",
  "reason": "missing email address"
}

Note: the reason field contains the cause of the error to help troubleshoot issues.

Downstream Partners and Redirects

Many of our channel partners are sensitive about redirects and do not enable 2nd Look Demand Partners who redirect the consumer from the channel partner’s experience into another company’s website. While not a launch requirement for the initial version of the Second Look Marketplace, your API will ideally return details corresponding to your downstream partner (name, logo, product type, marketing copy, and partner URL as listed in the example API response). If your API can do this, we will be able to enable you on many more channel sources, increasing your request volume. We may also require this in the future.

Reporting

Engine by MoneyLion will provide you with reporting for your offers that includes:

  • Number of time we polled your API (requests).

  • Number of API responses containing at least one offer (approvals).

  • Total number of offers returned by your API (if multiple per consumer).

  • Number of your offers displayed.

  • Number of unique clicks on your offers.

  • Average bid price for each of your product types.

  • Lead-level win/loss report.

Last updated

Was this helpful?