Get Loans
The investor can use these endpoints to fetch details of their loans, including those in pending, completed, in collection, or in default status.
Get Current Loans
The investor can use this endpoint to fetch their loans either in pending or in funded statuses.
HTTPS Request
GET https://api.lenmo.app/api/v3/loans/current_loan/
This endpoint returns a paginated response for loans that are associated with the investor, and they are completed.
Headers
Accept
String
The content type of the response.
X-API-KEY*
String
The API key that gives the user the authentication to perform this request.
X-Timestamp*
String
The timestamp of the request.
X-HMAC*
String
The HMAC generated for the request.
{
"count":2,
"next":null,
"previous":null,
"results":[
{
"id": 1,
"borrower_card_color": 3,
"loan_amount": 103213.009,
"payment_terms": 4,
"monthly_payment_amount": 40.5,
"loan_return": 123213.009,
"is_approved": True,
"loan_paid_off": False,
"loan_balance": 2221.21,
"interest_rate": 0.03,
"lender": {
// ... lender data ...
},
"next_payment_date": "2018-10-16 00:00:00+00:00",
"borrower": {
// ... borrower data ...
},
"status": "funded",
"loan_due_amount": 900.01,
"created_date": "2018-10-16 00:00:00+00:00",
"original_debt": 122.031,
"collected_amount": 900.1,
"remaining_debt": 100,
"collection_fee": 5,
"collected_percentage": 70.0,
"net_collected": 800,
"loan_request_id": 2,
}, ...
]
}{
"detail": "Authentication credentials were not provided."
}Sample Request
curl -X GET "https://api.lenmo.app/api/v3/loans/current_loan/" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "X-Timestamp: REQUEST_TIMESTAMP" \
-H "X-HMAC: REQUEST_HMAC"import requests
url = 'https://api.lenmo.app/api/v3/loans/current_loan/'
headers = {
'Accept': 'application/json',
'X-API-KEY': 'YOUR_API_KEY',
'X-Timestamp': 'REQUEST_TIMESTAMP',
'X-HMAC': 'REQUEST_HMAC'
}
r = requests.get(url, headers=headers)
print(r.text)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 {
String urlString = "https://api.lenmo.app/api/v3/loans/current_loan/";
URL url = new URL(urlString);
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("X-API-KEY", "YOUR_API_KEY");
connection.setRequestProperty("X-Timestamp", "REQUEST_TIMESTAMP");
connection.setRequestProperty("X-HMAC", "REQUEST_HMAC");
BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream(), "utf-8"));
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
url = URI("https://api.lenmo.app/api/v3/loans/current_loan/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Accept"] = "application/json"
request["X-API-KEY"] = "YOUR_API_KEY"
request["X-Timestamp"] = "REQUEST_TIMESTAMP"
request["X-HMAC"] = "REQUEST_HMAC"
response = http.request(request)
puts response.body
const fetch = require('node-fetch');
const url = 'https://api.lenmo.app/api/v3/loans/current_loan/';
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.text())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
<?php
$url = "https://api.lenmo.app/api/v3/loans/current_loan/";
$headers = [
"Accept: application/json",
"X-API-KEY: YOUR_API_KEY",
"X-Timestamp: REQUEST_TIMESTAMP",
"X-HMAC: REQUEST_HMAC"
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
} else {
echo $response;
}
curl_close($ch);
?>
Get Completed Loans
The investor can use this endpoint to fetch their completed loans.
HTTPS Request
GET https://api.lenmo.app/api/v3/loans/completed_loan/
This endpoint returns a paginated response for loans that are associated with the investor, and they are completed.
Headers
Accept
String
The content type of the response.
X-API-KEY*
String
The API key that gives the user the authentication to perform this request.
X-Timestamp*
String
The timestamp of the request.
X-HMAC*
String
The HMAC generated for the request.
{
"count":2,
"next":null,
"previous":null,
"results":[
{
"id": 1,
"borrower_card_color": 3,
"loan_amount": 103213.009,
"payment_terms": 4,
"monthly_payment_amount": 40.5,
"loan_return": 123213.009,
"is_approved": True,
"loan_paid_off": False,
"loan_balance": 2221.21,
"interest_rate": 0.03,
"lender": {
// ... lender data ...
},
"next_payment_date": "2018-10-16 00:00:00+00:00",
"borrower": {
// ... borrower data ...
},
"status": "funded",
"loan_due_amount": 900.01,
"created_date": "2018-10-16 00:00:00+00:00",
"original_debt": 122.031,
"collected_amount": 900.1,
"remaining_debt": 100,
"collection_fee": 5,
"collected_percentage": 70.0,
"net_collected": 800,
"loan_request_id": 2,
}, ...
]
}{
"detail": "Authentication credentials were not provided."
}curl -X GET "https://api.lenmo.app/api/v3/loans/completed_loan/" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "X-Timestamp: REQUEST_TIMESTAMP" \
-H "X-HMAC: REQUEST_HMAC"import requests
# Fetch completed loans for the investor
url = 'https://api.lenmo.app/api/v3/loans/completed_loan/'
headers = {
'Accept': 'application/json',
'X-API-KEY': 'YOUR_API_KEY',
'X-Timestamp': 'REQUEST_TIMESTAMP',
'X-HMAC': 'REQUEST_HMAC'
}
r = requests.get(url, headers=headers)
print(r.text)curl -X GET "https://api.lenmo.app/api/v3/loans/completed_loan/" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "X-Timestamp: REQUEST_TIMESTAMP" \
-H "X-HMAC: REQUEST_HMAC"curl -X GET "https://api.lenmo.app/api/v3/loans/completed_loan/" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "X-Timestamp: REQUEST_TIMESTAMP" \
-H "X-HMAC: REQUEST_HMAC"Get Collection Loans
The investor can use this endpoint to fetch their funded loans which are in collection status.
HTTPS Request
GET https://api.lenmo.app/api/v3/loans/collection_loan/
This endpoint returns a paginated response for loans in collection status that are associated with the investor.
Headers
Accept
String
The content type of the response.
X-API-KEY*
String
The API key that gives the user the authentication to perform this request.
X-Timestamp*
String
The timestamp of the request.
X-HMAC*
String
The HMAC generated for the request.
{
"count":2,
"next":null,
"previous":null,
"results":[
{
"id": 1,
"borrower_card_color": 3,
"loan_amount": 103213.009,
"payment_terms": 4,
"monthly_payment_amount": 40.5,
"loan_return": 123213.009,
"is_approved": True,
"loan_paid_off": False,
"loan_balance": 2221.21,
"interest_rate": 0.03,
"lender": {
// ... lender data ...
},
"next_payment_date": "2018-10-16 00:00:00+00:00",
"borrower": {
// ... borrower data ...
},
"status": "funded",
"loan_due_amount": 900.01,
"created_date": "2018-10-16 00:00:00+00:00",
"original_debt": 122.031,
"collected_amount": 900.1,
"remaining_debt": 100,
"collection_fee": 5,
"collected_percentage": 70.0,
"net_collected": 800,
"loan_request_id": 2,
}, ...
]
}{
"detail": "Authentication credentials were not provided."
}curl -X GET "https://api.lenmo.app/api/v3/loans/collection_loan/" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "X-Timestamp: REQUEST_TIMESTAMP" \
-H "X-HMAC: REQUEST_HMAC"import requests
# Fetch loans in collection status for the investor
url = 'https://api.lenmo.app/api/v3/loans/collection_loan/'
headers = {
'Accept': 'application/json',
'X-API-KEY': 'YOUR_API_KEY',
'X-Timestamp': 'REQUEST_TIMESTAMP',
'X-HMAC': 'REQUEST_HMAC'
}
r = requests.get(url, headers=headers)
print(r.text)Get Default Loans
The investor can use this endpoint to fetch their loans in default status.
HTTPS Request
GET https://api.lenmo.app/api/v3/loans/default_loan/
This endpoint returns a paginated response for loans that are associated with the investor, and they are default.
Headers
Accept
String
The content type of the response.
X-API-KEY*
String
The API key that gives the user the authentication to perform this request.
X-Timestamp*
String
The timestamp of the request.
X-HMAC*
String
The HMAC generated for the request.
{
"count":2,
"next":null,
"previous":null,
"results":[
{
"id": 1,
"borrower_card_color": 3,
"loan_amount": 103213.009,
"payment_terms": 4,
"monthly_payment_amount": 40.5,
"loan_return": 123213.009,
"is_approved": True,
"loan_paid_off": False,
"loan_balance": 2221.21,
"interest_rate": 0.03,
"lender": {
// ... lender data ...
},
"next_payment_date": "2018-10-16 00:00:00+00:00",
"borrower": {
// ... borrower data ...
},
"status": "funded",
"loan_due_amount": 900.01,
"created_date": "2018-10-16 00:00:00+00:00",
"original_debt": 122.031,
"collected_amount": 900.1,
"remaining_debt": 100,
"collection_fee": 5,
"collected_percentage": 70.0,
"net_collected": 800,
"loan_request_id": 2,
}, ...
]
}{
"detail": "Authentication credentials were not provided."
}curl -X GET "https://api.lenmo.app/api/v3/loans/default_loan/" \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "X-Timestamp: REQUEST_TIMESTAMP" \
-H "X-HMAC: REQUEST_HMAC"import requests
# Fetch loans in default status for the investor
url = 'https://api.lenmo.app/api/v3/loans/default_loan/'
headers = {
'Accept': 'application/json',
'X-API-KEY': 'YOUR_API_KEY',
'X-Timestamp': 'REQUEST_TIMESTAMP',
'X-HMAC': 'REQUEST_HMAC'
}
r = requests.get(url, headers=headers)
print(r.text)Response Parameters
borrower_card_color
Integer
An integer value that reflect the risk level of the borrower.
loan_amount
Float
The amount of loan in USD
payment_terms
Integer
Number of payments to pay back the loan
monthly_payment_amount
Float
Payment amount in a month
loan_return
Float
Loan return after it is paid off
is_approved
Boolean
Approval status for the loan
loan_paid_off
Boolean
Status on the completion of the loan
loan_balance
Float
Current remaining loan balance to be paid off
interest_rate
Float
A value between 0.03 to 2.0 for the interest rate of the loan
lender
Dict
Contains lender data for loan
next_payment_date
Date
UTC time for the upcoming loan payment
borrower
Dict
Contains borrower data for loan
status
String
Current Loan Status
loan_due_amount
Float
The loan due amount
created_date
Date
UTC time for loan creation
original_debt
Float
Amount of debt for this loan
collected_amount
Float
Collected amount of the loan in USD
remaining_debt
Float
Amount of debt to be collected later
collection_fee
Float
Fee of collection
collected_percentage
Float
Percentage of the collection amount
net_collected
Float
The net value of the collection amount
loan_request_id
Integer
Loan request id, associated with this loan
Last updated