Logo

Order History

This sub-resource allows the user to retrieve BUY and SELL 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

startDate

String

No

Earliest date to retrieve order history for, in UTC format. Filter can be passed through up to the minute

endDate

String

No

Latest date to retrieve order history for, in UTC format. Filter can be passed through up to the minute

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. For non-list parameter types, the values must be separated by an `&`. For example

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

Basket Parameters:

In the order history response, two new fields may appear under each sell order. The orderCategory indicates the type for the sale: if the 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

allOrNoneFlag

Boolean

This parameter is only applicable to BASKET sell order. If it is set to
true, all loans in the basket must be settled/canceled at the same time; if it is set to false, the basket allows partial settlement

description

String

Description of the order

marketType

String

Market type of the order: PRIMARY or SECONDARY

orderCategory

String

Order category: INDIVIDUAL or BASKET. This attribute is only applicable to sell orders

orderCreatedDate

Date

Creation date of the order in ISO format

orderExecutionType

String

Execution type of the order: SELL or BUY

roomName

String

Name of the room where the order was placed

totalOutstandingPrincipal

BigDecimal

Total outstanding principal of the items in this order

totalAccruedInterest

BigDecimal

Total accrued interest of the items in this order

totalFees

BigDecimal

Total fee charged for all the items in this order

orderItems

Array

Array of items in this order

noteId

Integer

Unique LC assigned id for the Note

loanId

Integer

Unique LC assigned id for the loan. This is the same as the id loan attribute returned in the loan Listing result operation

status

String

Status of the sell order item

itemStatusReason

String

Reason of the current status

statusDate

Date

Timestamp when status was lastly updated in ISO format

startListingDate

Date

Start listing date of the item in ISO format. The item will show up in
get loan listings call at the next global listing time after the
specified startListingDate

listingExpirationDate

Date

Listing expiration date of the item in ISO format

outstandingPrincipal

BigDecimal

Outstanding principal of the item

accruedInterest

BigDecimal

Accrued interest of the item

fees

Array

Array of fees charged to the item

type

String

Type of the fee

amount

BigDecimal

Amount of the fee

Sample Response:
{
"investorId": 171504826,
"startDate": "2019-06-04T22:32:10.669Z",
"endDate": "2019-06-19T22:32:10.669Z",
"offset": 0,
"limit": 1,
"orders":[
{
"id": 123007,
"orderExecutionType": "BUY",
"orderCreatedDate": "2019-06-19T13:01:37.746Z",
"totalOutstandingPrincipal": "USD 38033.131141000000",
"totalAccruedInterest": "USD 134.066787272024",
"allOrNoneFlag": false,
"orderItems": [
{
"id": 125007,
"status": "EXECUTED",
"statusDate": "2019-06-19T21:57:00.579Z",
"loanId": 162580874,
"noteId": 205060532,
"bidPricePercent": 1,
"askPricePercent": 1,
"askPriceEffectiveDate": "2019-06-18T13:01:36.000Z",
"outstandingPrincipal": "19016.565570500000",
"accruedInterest": "67.033393636012",
"startListingDate": "2019-06-19T13:00:23.995Z"
},
{
"id": 125008,
"status": "LISTED",
"statusDate": "2019-06-19T13:01:37.716Z",
"loanId": 162580886,
"noteId": 205060563,
"bidPricePercent": 1,
"askPricePercent": 1,
"askPriceEffectiveDate": "2019-06-19T13:00:27.554Z",
"outstandingPrincipal": "19016.565570500000",
"accruedInterest": "67.033393636012",
"startListingDate": "2019-06-19T13:00:26.272Z"
},
{
"id": 314025,
"status": "REJECTED",
"statusDate": "2020-03-12T12:47:09.502Z",
"itemStatusReason": "NO_MATCHING_PRICE",
"loanId": 176520289,
"noteId": 214461188,
"bidPricePercent": 0.05,
"askPricePercent": 1,
"askPriceEffectiveDate": "2019-06-19T13:00:27.554Z",
"outstandingPrincipal": "19016.565570500000",
"accruedInterest": "69.344889968289",
"startListingDate": "2019-06-19T13:00:26.272Z"
},
],
"marketType": "SECONDARY"
},
{
"id": 455161,
"orderExecutionType": "SELL",
"orderCreatedDate": "2021-03-25T18:29:10.410Z",
"totalOutstandingPrincipal": "USD 33876.146368003700",
"totalAccruedInterest": "USD 742.410000000000",
"totalFees": "USD 170.090000000000",
"allOrNoneFlag": false,
"orderItems": [
{
"id": 719276,
"status": "EXECUTED",
"statusDate": "2021-03-25T18:35:03.795Z",
"loanId": 155389515,
"noteId": 206002121,
"bidPricePercent": 1,
"askPricePercent": 1,
"askPriceEffectiveDate": "2021-03-25T18:15:19.000Z",
"outstandingPrincipal": "18404.640689249000",
"accruedInterest": "428.950000000000",
"startListingDate": "2021-03-25T18:15:19.000Z"
"fees":[
{
"type": "SELLER_TRANSACTION_FEE",
"amount": "92.330000000000"
}
]
},
{
"id": 719277,
"status": "EXECUTED",
"statusDate": "2021-03-25T18:35:03.795Z",
"loanId": 154482451,
"noteId": 205233079,
"bidPricePercent": 1,
"askPricePercent": 1,
"outstandingPrincipal": "15471.505678754700",
"accruedInterest": "313.460000000000",
"startListingDate": "2021-03-25T18:15:19.000Z"
"fees":[
{
"type": "SELLER_TRANSACTION_FEE",
"amount": "77.760000000000"
}
]
}
],
"orderCategory": "INDIVIDUAL",
"marketType": "SECONDARY"
}
]
}

HTTP status summary:

Code

Description

200

Success

400

Validation or business error

401

Unauthorized

403

Forbidden

404

Not Found

452

Market closed

500

Unexpected failure

Sell order itemStatusReason values

status

itemStatusReason

Scenario

EXPIRED

RESERVE_PRICE_CROSSED

When the sell order item crosses the reserve price and has been unsold

EXPIRED

USER_EXPIRATION_DATE_CROSSED

When the sell order item crosses the user expiration date and has been unsold

CANCELED

OWNER_CHANGE

When the note ownership has changed for a listed loan and corresponding sell order item has been canceled

CANCELED

STATUS_CHANGE

When the loan status is no longer CURRENT OR ISSUED and corresponding sell order item has been canceled

CANCELED

INVALID_NOTE_DETAIL

When a sell order item has been marked as canceled due to missing data for one of the several attributes

CANCELED

NOTE_DETAIL_NOT_FOUND

When a sell order item has been marked canceled due to missing note data

CANCELED

MANUAL

When a sell order or sell order item has been canceled by the seller using the API

CANCELED

OTHER

When the sell order item is marked canceled due to the outstanding principal being

EXECUTION_FAILED

ZERO_REMAINING_PRINCIPAL

When the sell order settlement fails due to outstanding principal on loan being 0

EXECUTION_FAILED

INVALID_LOAN_STATUS

When the sell order settlement fails due to the loan being in an invalid status

EXECUTION_FAILED

INVALID_LOAN_OWNER

When the sell order settlement fails due to the seller not being the owner of the loan

EXECUTION_FAILED

INVALID_SELLER_BANK_ACCOUNTINVALID_SELLER_BANK_ACCOUNT

When the sell order settlement fails due to problems with seller’s bank account information

CANCELED

CAUSED_BY_OTHER_BASKET_ITEM

When one of the sell order items in sell order is canceled, all others are marked with this status/reason combo

EXPIRED

CAUSED_BY_OTHER_BASKET_ITEM

When one of the sell order items in sell order is expired, all others are marked with this status/reason combo

CANCELED

INVALID_LOAN_ORIGINATOR

When the sell order settlement fails due to originator of the loan not being allowed in the room


Buy order itemStatusReason values:

status

itemStatusReason

Scenario

REJECTED

ITEM_ALREADY_WON

When the buy order fails due to selection of a competing bid for the loan

REJECTED

OPEN_ROOM_DOES_NOT_EXIST

When the buy order fails as the room is closed

REJECTED

BUYER_NOT_ACTIVE_ROOM_PARTICIPANT

When the buy order fails due to the buyer not being an active participant in the room

REJECTED

BUYER_SAME_AS_SELLER

When the buy order fails acceptance due to buyer being same as seller

REJECTED

NO_MATCHING_PRICE

When the buy order fails due to bid price being less than the asking price

REJECTED

ITEM_NOT_LISTED

When the buy order fails due to the sell order item no longer being listed on the platform

REJECTED

ITEM_ALREADY_EXPIRED

When the buy order fails due to the expiration of the corresponding sell order item listing

REJECTED

ORDER_ALREADY_PLACED

When the buy order fails due to pre-existing buy order from buyer for the sell order item

EXECUTION_FAILED

INSUFFICIENT_CASH

When the buy order settlement fails due to insufficient cash in buyer’s account to cover the loan purchase

EXECUTION_FAILED

INVALID_BUYER_BANK_ACCOUNT

When the buy order settlement fails due to problems with the buyer bank account

EXECUTION_FAILED

INVALID_BASKET_ORDER

When a basket buy order is rejected due to one of the following reasons
during winner selection: 1) Not all items from basket sell order are included in the basket buy order 2) Duplicate buy order

REJECTED

ITEM_REJECTED_WITHIN_BASKET

At the time of processing buy order, when one of the items in the basket buy order is rejected, all others are marked with this status


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.