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

Name	Type	Description
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.

200: OK A paginated list of loans either pending or funded

{
   "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,
      }, ...
   ]
}

403: Forbidden Permission Denied

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

Sample Request

cURL

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"

Python

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)

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

Name	Type	Description
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.

200: OK A paginated list of loans either pending or funded

{
   "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,
      }, ...
   ]
}

403: Forbidden Permission Denied

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

cURL

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"

Python

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

Name	Type	Description
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.

200: OK A paginated list of loans either pending or funded

{
   "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,
      }, ...
   ]
}

403: Forbidden Permission Denied

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

cURL

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"

Python

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

Name	Type	Description
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.

200: OK A paginated list of loans either pending or funded

{
   "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,
      }, ...
   ]
}

403: Forbidden Permission Denied

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

cURL

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"

Python

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

Parameter	Type	Description
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