Loans API

List Loans

Get list of loans, paginated. This method doesn't need authentication with JWT token

Parameters

Description

Type

Example

limit
Optional
Limit the returned results. Possible values: any integer between 0 and 500. 10 by default integer limit=50
offset
Optional
Skip the first <offset> results. Possible values: any positive integer or 0. 0 by default integer offset=10
country
Optional
Country of the borrower. 2 letter code of a country, according to ISO_3166-1 list<string> country=US,CA,GB
type
Optional
Loan type. Possible values: [home_improvement, debt_consolidation, business, investing, other, reputation, hosted_mining, atm_purchase, blc_investing, day_trading, localbitcoins_trading, lending, purchasing_goods, capital_for_business] list<string> type=investing,other
term
Optional
Loan term. Possible values: [1, 7, 14, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 360, 540, 720, 1080] list<integer> term=1,7,14
frequency
Optional
Loan frequency. Possible values: [1, 7, 14, 30] list<integer> frequency=1,7
status
Optional
Loan status. Possible values: [funding, funded, repaid_closed, expired, canceled, canceled_suspicious, signing] list<string> status=funding,funded
trusted
Optional
Borrower verified trusted connections. Possible values: [ebay, amazon, localbitcoins, paypal] list<string> trusted=ebay,amazon
social
Optional
Borrower verified social connections. Possible values: [facebook, google, twitter, linkedin] list<string> social=facebook,google
amountFrom
Optional
Loan amount from. Possible values: any positive floating number float amountFrom=0.001
amountTo
Optional
Loan amount to. Possible values: any positive floating number float amountTo=1.3
reputationFrom
Optional
Borrower reputation from. Possible values: any integer integer reputationFrom=30
reputationTo
Optional
Borrower reputation to. Possible values: any integer integer reputationTo=100
timeLeftFrom
Optional
Time left from in days for funding of the loan. Applicable only to loans in status funding. Possible values: An integer between 0 and 30 integer timeLeftFrom=0
timeLeftTo
Optional
Time left to in days for funding of the loan. Applicable only to loans in status funding. Possible values: An integer between 0 and 30 integer timeLeftTo=30
denomination
Optional
Lona denomination. Possible values: [btc, usd] list<string> denomination=btc,usd
paymentStatus
Optional
Loan payment status. Possible values: [current, late, default, collected] list<string> paymentStatus=current,late
fundedFrom
Optional
Loan percent funded from. Possible values: any floating number between 0 and 100 float fundedFrom=30
fundedTo
Optional
Loan percent funded to. Possible values: any floating number between 0 and 100 float fundedTo=60
ratioFrom
Optional
Borrower's active-to-repaid ratio from. Possible values: any integer between 0 and 100 integer ratioFrom=0
ratioTo
Optional
Borrower's active-to-repaid ratio to. Possible values: any integer between 0 and 100 integer ratioTo=10
listingDateFrom
Optional
Loan listing date from. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) listingDateFrom=03-10-2014
listingDateTo
Optional
Loan listing date to. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) listingDateTo=12-05-2015
expirationDateFrom
Optional
Loan expiration date from. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) expirationDateFrom=03-10-2014
expirationDateTo
Optional
Loan expiration date to. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) expirationDateTo=12-05-2015
repaidDateFrom
Optional
Loan repaid date from. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) repaidDateFrom=03-10-2014
repaidDateTo
Optional
Loan repaid date to. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) repaidDateTo=12-05-2015
dueDateFrom
Optional
Loan due date from. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) dueDateFrom=03-10-2014
dueDateTo
Optional
Loan due date to. Possible values: string representation of a date in the format 'day-month-year' string(d-m-Y) dueDateFrom=12-05-2015
votesFrom
Optional
Loan votes from. Possible values: any positive integer or 0, smaller then or equal to 'votesTo' if present integer votesFrom=3
votesTo
Optional
Loan votes to. Possible values: any positive integer or 0, bigger then or equal to 'votesFrom' if present integer votesTo=10
salary
Optional
Integer representation of the income range of the borrower.
1 => [0],
2 => [1,10000],
3 => [10001,30000],
4 => [30001,60000],
5 => [60001,90000],
6 => [90001,150000],
7 => 150001+
list<integer> salary=1,2,3

Example

                    
GET /api/loans?paymentStatus=current&denomination=usd,btc HTTP/1.1
Host: api.bitlendingclub.com
Accept: application/vnd.blc.v1+json
Cache-Control: no-cache
                

Response

						
{
    "loans":
    [
        {
            "id": 4,
            "type": "Business",
            "title": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
            "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "amount": 10,
            "term": 80,
            "frequency": 20,
            "status": "Expired",
            "paymentStatus": "Current",
            "createdAt": null,
            "expirationDate": "2013-07-31T23:59:59.000+03:00",
            "paymentDueDate": null,
            "dateRepaid": null,
            "denomination": "btc",
            "creditScore": "A3",
            "percentFunded": 0,
            "votes": 0,
            "borrower": 12,
            "countryId": "BD",
            "salary": null,
            "rating": 0,
            "social_facebook": 0,
            "social_linkedin": 0,
            "social_google": 0,
            "social_twitter": 0,
            "trusted_paypal": 0,
            "trusted_amazon": 0,
            "trusted_localbitcoins": 0,
            "trusted_ebay": 0,
            "chargeUp": "4.23"
        },
        {
            "id": 9,
            "type": "Business",
            "title": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
            "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "amount": 0.5,
            "term": 3,
            "frequency": 1,
            "status": "Funded",
            "paymentStatus": "Current",
            "createdAt": "2013-08-01T15:45:54.000+03:00",
            "expirationDate": "2013-07-18T23:59:59.000+03:00",
            "paymentDueDate": "2013-08-03T23:59:59.000+03:00",
            "dateRepaid": null,
            "denomination": "btc",
            "creditScore": "C4",
            "percentFunded": 100,
            "votes": 0,
            "borrower": 28,
            "countryId": "USD",
            "salary": null,
            "rating": -20,
            "social_facebook": 0,
            "social_linkedin": 0,
            "social_google": 0,
            "social_twitter": 0,
            "trusted_paypal": 0,
            "trusted_amazon": 0,
            "trusted_localbitcoins": 0,
            "trusted_ebay": 0,
            "chargeUp": "35.56"
        }
    ]
}