List borrower's loan request

This endpoint retrieves a list of loan requests based on specific criteria. The returned active loan requests will only include those issued within the last 30 days

HTTPS Request

GET https://api.lenmo.app/api/v3/loan_requests/

This endpoint retrieves a list of loan requests based on specific criteria. The returned loan requests will only include those issued within the last 30 days. and exclude requests where:

Path Parameters

Name	Type	Description
lenmo_color	Integer	0 : Low Risk 1 : Medium Risk 2 : High Risk 3 : Facebook Friends 4 : Crypto-backed Loans
credit_score	NumericRange	Loan requests associated to borrower with credit score in between a range.
loan_amount	NumericRange	Loan requests with respective amount range
loan_terms	NumericRange	Loan requests of a certain range of loan terms.
completed_loans	Numeric Filter	Loan requests associated to borrower that have this completed loan count. Accepts numeric choices or numeric range or both. Examples: ?completed_loans=1,2,3 ?completed_loans=1-3 ?completed_loans=1,2,3-10
invited_borrowers	Boolean	Loan requests associated to invited borrowers.
previous_borrowers	Boolean	Loan requests associated to previous borrowers with completed loans.
state	string	Loan requests associated to one or multiple state (Note: you can enter NY or New York and it's not case sensitives ) you can also add multiple states by separating between them with , (e.g. CA,NY,..)
zip_code	String	Loan requests associated to one or multiple zip code you can add more than one by separating between them with,
nearby_zipcodes	Boolean	Loan requests linked to one or more zip codes of the lender aligned with the zip codes of borrowers.

Headers

Name	Type	Description
X-API-KEY*	String	The API key that gives the user the authentication to perform this request.
Accept	String
X-Timestamp*	String	The timestamp of the request.
X-HMAC*	String	The HMAC generated for the request.

Sample Request

cURL

curl -X GET "https://api.lenmo.app/api/v3/loan_requests/" \
    -H "accept: application/json" \
    -H "X-API-KEY: YOUR_API_KEY" \
    -H "X-Timestamp: REQUEST_TIMESTAMP" \
    -H "X-HMAC: REQUEST_HMAC"

Python

import requests

url = 'https://api.lenmo.app/api/v3/loan_requests/'

headers = {
    "Accept": "application/json",
    "X-API-KEY": "YOUR_API_KEY",
    "X-Timestamp": "REUQUEST_TIMESTAMP",
    "X-HMAC": "REQUEST_HMAC",
}

r = requests.get(url, headers=headers)

print(r.text)

Java

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Main {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.lenmo.app/api/v3/loan_requests/");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("GET");
            con.setRequestProperty("Accept", "application/json");
            con.setRequestProperty("X-API-KEY", "YOUR_API_KEY");
            con.setRequestProperty("X-Timestamp", "REQUEST_TIMESTAMP");
            con.setRequestProperty("X-HMAC", "REQUEST_HMAC");

            BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
            String inputLine;
            StringBuilder content = new StringBuilder();
            while ((inputLine = in.readLine()) != null) {
                content.append(inputLine);
            }
            in.close();

            System.out.println(content.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Ruby

require 'net/http'
require 'uri'
require 'json'

url = 'https://api.lenmo.app/api/v3/loan_requests/'
uri = URI.parse(url)

headers = {
  "Accept" => "application/json",
  "X-API-KEY" => "YOUR_API_KEY",
  "X-Timestamp" => "REQUEST_TIMESTAMP",
  "X-HMAC" => "REQUEST_HMAC"
}

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri.request_uri)
headers.each { |key, value| request[key] = value }

response = http.request(request)
puts response.body

Node.Js

const fetch = require('node-fetch');

const url = 'https://api.lenmo.app/api/v3/loan_requests/';

const headers = {
    "Accept": "application/json",
    "X-API-KEY": "YOUR_API_KEY",
    "X-Timestamp": "REQUEST_TIMESTAMP",
    "X-HMAC": "REQUEST_HMAC",
};

fetch(url, {
    method: 'GET',
    headers: headers
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://api.lenmo.app/api/v3/loan_requests/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");

$headers = array();
$headers[] = "Accept: application/json";
$headers[] = "X-API-KEY: YOUR_API_KEY";
$headers[] = "X-Timestamp: REQUEST_TIMESTAMP";
$headers[] = "X-HMAC: REQUEST_HMAC";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

echo $result;
?>

Sample Response

200: OK Returns a paginated list of the queried loan requests

{
  "count": 5155,
  "next": "https://api.lenmo.app/api/v3/loan_requests/?page=2",
  "previous": null,
  "results": [
    {
      "id": 147132,
      "borrower": {
        "id": 541966,
        "avatar": 1,
        "initial": "TM",
        "lenmo_score": 68,
        "credit_score": "620 - 630",
        "lenmo_color": 4,
        "hard_inquiries": 1,
        "deregatory_mark": 0,
        "total_accounts": 2,
        "credit_utilization": 1.02,
        "annual_income": 24000,
        "payment_history": 100,
        "completed_loans_count": 0
      },
      "borrower_card_color": 4,
      "loan_amount": "200.00",
      "loan_terms": 1,
      "total_amount": "203.11",
      "total_fees": "3.11",
      "fee_legislative": "0.11",
      "fee_extra": "0.00",
      "fee_lenmo": "3.00",
      "created": "2023-02-12T22:59:57.355382Z",
      "fav_loan_request_id": null,
      "lenme_prediction_purchased": false,
      "count_views": 5,
      "census_tract_geo_id": "12345",
      "max_interest_rate": 0.25,
      "borrower_data_aggs": {
        "avg_credit": 83.39,
        "avg_debit": 0,
        "sum_values": [
          {
            "CREDIT": 0,
            "DEBIT": 0
          },
          {
            "CREDIT": 0,
            "DEBIT": 0
          },
          {
            "CREDIT": 250,
            "DEBIT": 0
          }
        ]
      },
      "crypto_currency": "BTC",
      "crypto_amount": "0.000001",
      "crypto_interest_rate": 0.25,
      "crypto_logo": "www.example.com/btc-logo",
      "crypto_name": "Bitcoin",
      "crypto_market_value": "100000",
      "highlight": {
        'status': 0,
        'title': 'New loan alert!',
        'message': 'Be the first to grab a fantastic opportunity!'
      }
    },
    {
      "id": 147133,
      "borrower": {
        "id": 541955,
        "avatar": 1,
        "initial": "TM",
        "lenmo_score": 68,
        "credit_score": "620 - 630",
        "lenmo_color": 1,
        "hard_inquiries": 1,
        "deregatory_mark": 0,
        "total_accounts": 2,
        "credit_utilization": 1.02,
        "annual_income": 24000,
        "payment_history": 100,
        "completed_loans_count": 0
      },
      "borrower_card_color": 1,
      "loan_amount": "200.00",
      "loan_terms": 1,
      "total_amount": "203.11",
      "total_fees": "3.11",
      "fee_legislative": "0.11",
      "fee_extra": "0.00",
      "fee_lenmo": "3.00",
      "created": "2023-02-12T22:59:57.355382Z",
      "fav_loan_request_id": null,
      "lenme_prediction_purchased": false,
      "count_views": 5,
      "census_tract_geo_id": "12345",
      "max_interest_rate": 0.25,
      "borrower_data_aggs": {
        "avg_credit": 83.39,
        "avg_debit": 0,
        "sum_values": [
          {
            "CREDIT": 0,
            "DEBIT": 0
          },
          {
            "CREDIT": 0,
            "DEBIT": 0
          },
          {
            "CREDIT": 250,
            "DEBIT": 0
          }
        ]
      },
      "highlight": {
        'status': 0,
        'title': 'New loan alert!',
        'message': 'Be the first to grab a fantastic opportunity!'
      }
    }
  ]
}

403: Forbidden Permission denied

{
    "detail": "Authentication credentials were not provided."
}

Response Parameters

Parameter	Type	Description
id	Number	This is the loan request ID
Borrower's id	Number	This is the borrower's ID the requested the loan
intial	String	Borrower's Intial
lenmo_color	Integer	Lenme scoring model that measure the risk level.
credit_score	String	Credit score range - borrower's credit score range in a 10-point range.
hard_inquiries	Integer	Number of hard inquires as per the credit report of the borrower.
deregatory_mark	Integer	Deregatory mark as per the credit report of the borrower.
total_accounts	Integer	Number of total accounts as per the credit report of the borrower.
credit_utilization	Float	Credit utilization as per the credit report of the borrower.
annual_income	Float	TransUnion annual income.
payment_history	Float	TransUnion Payment History
completed_loans_count	Integer	Number of completed loans for this borrower. Retrive Borrower's loan history.
borrower_card_color	Integer	An integer value that reflect the risk level of the borrower.
loan_amount	Float	The amount of loan in USD
loan_terms	Integer	Number of loan terms for this loan request
total_amount	Float	The total amount of loan including fees
total_fees	Float	The total fees for the loan
fee_legislative	Float	Legislative fees for the loan
fee_extra	Float	Lenme extra fees
fee_lenmo	Float	Lenme fees
created	Date	Date of loan request creation
fav_loan_request_id	Long	Id of a favourite loan request
lenme_prediction_purchased	Boolean	Is LenmePredict purchased for this loan?
count_views	Integer	Number of loan requests views
crypto_currency	String	Type of crypto currency if crypto loan request.
crypto_amount	Float	Crypto amount if crypto loan request.
crypto_logo	String	URL for the crypto currency logo if crypto loan request.
crypto_name	String	Name of the crypto currency if crypto loan request.
crypto_market_value	Float	The market value of the crypto currency if crypto loan request.
census_tract_geo_id	String	Census tract GEO ID: A unique Geographic Identifier used by the United States Census Bureau to uniquely identify a specific census tract. It is a concatenation of several codes that uniquely define the geographic location.
max_interest_rate	Float	The maximum interest rate that can be offered for this loan request. The maximum interest rate varies based on different parameters, including the borrower's state, type of loan, and other factors.
borrower_data_aggs	JSON	Aggregation of the borrower's financial activities over the last 90 days.
Highlight	JSON	The highlight object is used to inform lenders about the status of the loan request. A highlight object consists of: status: The status of the loan request. Possible values: 1: new loan request. 2: the loan request was viewed. 3: the loan request was offered. title: The title of the highlight. message: Shows how many views or offers for this loan request.