Logo

Order History

This sub-resource allows the user to retrieve BUY order history information.

Operation: GET

URL: https://api.lendingclub.com/api/lcx/v1/investors/{investor-id}/orders/history

Path Parameters:

Name

Type

Required

Description

Investor-id

Integer

Yes

Investor’s Actor ID

Query Parameters:

Name

Type

Required

Description

orderTypes

List

No

Types of orders made. e.g. “BUY” or “SELL”

orderItemStatuses

List

No

Status of orders being retrieved. e.g. “EXECUTED”

Offset

Integer

No

Retrieve a subset of loans starting with the offset value

limit

Integer

No

Limit the number of results returned. Default value is 10

startDate

String

No

Earliest
date to retrieve order history for, in UTC format. Filter can be passed
through up to the minute. Eg. 2020-05-03T22:45:56.348Z

endDate

String

No

Latest
date to retrieve order history for, in UTC format. Filter can be passed
through up to the minute. Eg. 2020-10-03T22:45:56.348Z

marketTypes

String

No

Accepted
inputs are “PRIMARY” or “SECONDARY” and will return only orders from
that market. No input will return orders from both markets

Supported formats: JSON

Request Payload:

JSON request for submit order For the parameters where the Type is a List, the different values must be separated by commas, whereas for non-list parameter types, the values
must be separated by an `&`.

For example:

https://api.lendingclub.com/api/lcx/v1/investors/14212716/orders/history?orderTypes=BUY&orderItemStatuses=REJECTED,CONFIRMED&startDate=2019-10-31T10:05:45-08:00

Basket Parameters:

In order history response, two new fields may appear under each sell order:


orderCategory indicates the type for the sale, if value is BASKET then the sell order
is BASKET sale. Otherwise it is individual.

Response Parameters:

Name

Type

Description

investorId

Integer

Investor’s Actor ID

startDate

String

Start date of the order history

endDate

String

End date of the order history

offset

BigDecimal

Offset
to only return orders beginning from this value. For example, a value
of 6 would only return orders from the 6th order onwards

limit

Integer

Limit of the number of orders returned

orders

An array of orders (see details below)

orders:

Name

Type

Description

orderExecutionType

String

Order Type

orderCreatedDate

String

Date the order was created

totalOutstandingPrincipal

BigDecimal

Principal outstanding on the loan

totalAccruedInterest

BigDecimal

Interest accrued on the loan

orderItems

String

The items and details related to the order (see details below)

auctionType

String

Describes the auction type for the trade – “ACTIVE”

orderItems:

Name

Type

Description

id

Integer

Unique id for the order

status

String

Status of the order being retrieved: Listed, Executed, Rejected, Execution_Failed

statusDate

String

Date of the status

itemStatusReason

String

Reason
for the rejection, only used when status is "Rejected" Possible Values:
NO_MATCHING_PRICE, ITEM_ALREADY_WON, ITEM_NOT_LISTED,
ORDER_ALREADY_PLACED, ITEM_ALREADY_EXPIRED,
ITEM_BELONGS_TO_BASKET,ITEM_REJECTED_WITHIN_BASKET,
INVALID_BASKET_ORDER, OPEN_ROOM_DOES_NOT_EXIST,
BUYER_NOT_ACTIVE_ROOM_PARTICIPANT

loanId

String

Unique LendingClub ID number for the loan

bidPricePercent

Big Decimal

1.0 is 100% or par

askPricePercent

Big Decimal

askPricePercentage * PrincipalOutstanding + accruedInterest * 100% = askPrice

askPriceEffectiveDate

Big Decimal

Date the ask price became effective

outstandingPrincipal

Big Decimal

Principal outstanding on the loan

startListingDate

String

Listing date of the loan

roomName

String

Room that the order was placed in

HTTP Status Summary:

Code

Description

200

Success

202

Accepted

400

Validation or business error

401

Unauthorized

403

Forbidden

404

Not found

500

Unexpected failure

Sample Request:

https://api.lendingclub.com/api/lcx/v1/investors/123123123/orders/history?marketTypes=PRIMARY

Sample Response:

{

"investorId": 123123123,

"startDate": "2020-05-11T19:24:18.955Z",

"endDate": "2020-05-26T19:24:18.955Z",

"limit": 10,

"orders": [
{

"id": 64106,

"orderExecutionType": "BUY",

"orderCreatedDate": "2020-05-26T19:10:59.201Z",

"totalOutstandingPrincipal": "USD 0.000000000000",

"totalAccruedInterest": "USD 0.000000000000",

"orderItems":
{

"id": 76279,

"status": "REJECTED",

"statusDate": "2020-05-26T19:12:00.504Z",

"itemStatusReason": "SUBMIT_ORDER_LOAN_LEVEL_FAILURE",

"loanId": 181932125,

"bidPricePercent": 1.000000000000,

"askPricePercent": 1.000000000000,

"askPriceEffectiveDate": "2020-05-26T17:00:00.000Z",

"outstandingPrincipal": "0.000000000000",

"accruedInterest": "0.000000000000",

"startListingDate": "2020-05-26T16:21:40.432Z",

"roomName": "PRIMARY_MARKET"

}
],

"marketType": "PRIMARY",

"auctionType": "ACTIVE"

},
{

"id": 64103,

"orderExecutionType": "BUY",

"orderCreatedDate": "2020-05-26T19:09:09.112Z",

"totalOutstandingPrincipal": "USD 0.000000000000",

"totalAccruedInterest": "USD 0.000000000000",

"orderItems": [
{

"id": 76276,

"status": "REJECTED",

"statusDate": "2020-05-26T19:09:09.118Z",

"loanId": 181922168,

"bidPricePercent": 1.000000000000,

"askPricePercent": 1.000000000000,

"askPriceEffectiveDate": "2020-05-26T19:06:37.511Z",

"outstandingPrincipal": "0.000000000000",

"accruedInterest": "0.000000000000",

"startListingDate": "2020-05-26T19:06:37.511Z",

"roomName": "PRIMARY_MARKET"

}
],

"marketType": "PRIMARY",

"auctionType": 'ACTIVE"

},
{

"id": 64063,

"orderExecutionType": "BUY",

"orderCreatedDate": "2020-05-22T21:02:28.542Z",

"totalOutstandingPrincipal": "USD 10625.000000000000",

"totalAccruedInterest": "USD 0.000000000000",

"orderItems": [
{

"id": 76168,

"status": "EXECUTED",

"statusDate": "2020-05-22T21:03:57.845Z",

"loanId": 181379133,

"bidPricePercent": 0.900000000000,

"askPricePercent": 0.900000000000,

"askPriceEffectiveDate": "2020-05-22T21:00:00.000Z",

"outstandingPrincipal": "10625.000000000000",

"startListingDate": "2020-05-22T21:00:00.000Z",

"roomName": "PRIMARY_MARKET"

}
],

"marketType": "PRIMARY",

"auctionType": "ACTIVE"

},
{

"id": 64061,

"orderExecutionType": "BUY",

"orderCreatedDate": "2020-05-22T21:00:16.983Z",

"totalOutstandingPrincipal": "USD 10625.000000000000",

"totalAccruedInterest": "USD 0.000000000000",

"orderItems": [
{

"id": 76166,

"status": "EXECUTED",

"statusDate": "2020-05-22T21:03:12.824Z",

"loanId": 181379128,

"bidPricePercent": 1.100000000000,

"askPricePercent": 1.100000000000,

"askPriceEffectiveDate": "2020-05-22T21:00:00.000Z",

"outstandingPrincipal": "10625.000000000000",

"startListingDate": "2020-05-22T21:00:00.000Z",

"roomName": "PRIMARY_MARKET"

}
],

"marketType": "PRIMARY",

"auctionType": "ACTIVE"

},
{

"id": 64060,

"orderExecutionType": "BUY",

"orderCreatedDate": "2020-05-22T19:00:54.259Z",

"totalOutstandingPrincipal": "USD 1000.000000000000",

"totalAccruedInterest": "USD 0.000000000000",

"orderItems": [
{

"id": 76165,

"status": "EXECUTED",

"statusDate": "2020-05-22T19:04:01.126Z",

"loanId": 181379131,

"bidPricePercent": 1.000000000000,

"askPricePercent": 1.000000000000,

"askPriceEffectiveDate": "2020-05-22T19:00:52.684Z",

"outstandingPrincipal": "1000.000000000000",

"accruedInterest": "0.000000000000",

"startListingDate": "2020-05-22T19:00:52.684Z",

"roomName": "PRIMARY_MARKET"

}
],

"marketType": "PRIMARY",

"auctionType": "ACTIVE"

},
{

"id": 64058,

"orderExecutionType": "BUY",

"orderCreatedDate": "2020-05-22T17:10:42.507Z",

"totalOutstandingPrincipal": "USD 10625.000000000000",

"totalAccruedInterest": "USD 0.000000000000",

"orderItems": [
{

"id": 76163,

"status": "EXECUTED",

"statusDate": "2020-05-22T17:15:51.984Z",

"loanId": 181402120,

"bidPricePercent": 1.100000000000,

"askPricePercent": 1.100000000000,

"askPriceEffectiveDate": "2020-05-22T17:00:00.000Z",

"outstandingPrincipal": "10625.000000000000",

"startListingDate": "2020-05-22T17:00:00.000Z",

"roomName": "PRIMARY_MARKET"

}
],

"marketType": "PRIMARY",

"auctionType": "ACTIVE"

}
]

}

Unless otherwise specified, all credit and deposit products are provided by LendingClub Bank, N.A., Member FDIC, Equal Housing Lender (“LendingClub Bank”), a wholly-owned subsidiary of LendingClub Corporation, NMLS ID 167439. Credit products are subject to credit approval and may be subject to sufficient investor commitment. Credit union membership may be required. Deposit accounts are subject to approval. Deposit products are FDIC-insured up to $250,000 per depositor, per ownership category.

"LendingClub" and the "LC" symbol are trademarks of LendingClub Bank.

© 2024 LendingClub Bank. All rights reserved.