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.

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": 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,
      "crypto_currency": null,
      "crypto_amount": null,
      "crypto_logo": null,
      "crypto_name": null,
      "crypto_market_value": null,
      "crypto_interest_rate": null
    },

403: Forbidden Permission denied

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

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)

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;
?>

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

Go

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://api.lenmo.app/api/v3/loan_requests/"
    client := &http.Client{}
    req, _ := http.NewRequest("GET", url, nil)

    req.Header.Add("Accept", "application/json")
    req.Header.Add("X-API-KEY", "YOUR_API_KEY")
    req.Header.Add("X-Timestamp", "REQUEST_TIMESTAMP")
    req.Header.Add("X-HMAC", "REQUEST_HMAC")

    resp, _ := client.Do(req)
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)

    fmt.Println(string(body))
}

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();
        }
    }
}

Sample JSON Response

{
    "id": 11,
    "borrower": {
        "id": 1,
        "avatar": 2,
        "initial": "LR",
        "lenmo_score": 79,
        "credit_score": "710 - 720",
        "lenmo_color": 2,
        "hard_inquiries": 0,
        "deregatory_mark": 0,
        "total_accounts": 26,
        "credit_utilization": 0.0,
        "annual_income": 60000.0,
        "payment_history": 91.0,
        "completed_loans_count": 0
    },
    "borrower_card_color": 2,
    "loan_amount": "100.00",
    "loan_terms": 2,
    "total_amount": "103.11",
    "total_fees": "3.11",
    "fee_legislative": "0.11",
    "fee_extra": "0.00",
    "fee_lenmo": "3.00",
    "count_views": 0,
    "created": "2024-02-06T16:01:40.631007Z",
    "fav_loan_request_id": null,
    "lenme_prediction_purchased": false,
    "crypto_currency": null,
    "crypto_amount": null,
    "crypto_logo": null,
    "crypto_name": null,
    "crypto_market_value": null,
    "crypto_interest_rate": null
}

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.
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?
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
crypto_name	String	Name of the crypto currency
crypto_market_value	Float	The market value of the crypto currency
crypto_interest_rate	Float	Fixed value of crypto interest rate (0.25)