This sub-resource allows the user to get information on one of their own sell orders.
Operation: GET
URL: https://api.lendingclub.com/api/lcx/v1/secondary/investors/{investor-id}/orders/sell-order/{order-id}
Path Parameters:
Name | Type | Description |
---|---|---|
investorId | Integer | Investor’s Actor ID |
orderCategory | String | Category of the sell order. Possible values are INDIVIDUAL and BASKET |
orderType | String | LIMIT |
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 | Optional description of the sell order |
roomName | String | The name of the room where the sell order is created |
items | Array | The array of items in the sell order |
askPriceBasis | String | Only PRINCIPAL is supported |
askPricePercent | BigDecimal | The starting ask price of the item vs par. 1.0 is 100% or par |
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 |
statusReason | 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. It is capped at 30 days after startListingDate |
pricePlan | Object | Price plan of this item. Only need this in the request payload if you need to configure price tick down plan |
reservedAskPricePercent | BigDecimal | Reserved price of the item vs par. 1.0 is 100% or par. The Item will be delisted if its price drops below this value |
tickPercent | BigDecimal | The percentage of daily ticking down vs par. 1.0 is 100% or par |
Sample Response:
{
"id": 463017,
"investorId": "202101826",
"orderType": "LIMIT",
"orderCategory": "INDIVIDUAL",
"description": "Test sell order (optional)",
"roomName": "CENTRAL_MARKET",
"allOrNoneFlag": false,
"items": [
{
"id": 727019,
"statusDate": "2021-04-01T21:18:40.504Z",
"status": "PENDING",
"noteId": "215414933",
"loanId": "169060877",
"askPricePercent": 1.01,
"askPriceBasis": "PRINCIPAL",
"startListingDate": "2021-05-03T16:00:00.000Z",
"listingExpirationDate": "2021-05-15T16:00:00.000Z",
"pricePlan": {
"tickPercent": -0.01,
"reservedAskPricePercent": 0.85
}
},
{
"id": 727018,
"statusDate": "2021-04-01T21:18:40.504Z",
"status": "PENDING",
"noteId": "215470136",
"loanId": "169052568",
"askPricePercent": 1,
"askPriceBasis": "PRINCIPAL",
"startListingDate": "2021-05-03T16:00:00.000Z",
"listingExpirationDate": "2021-05-25T16:00:00.000Z",
"pricePlan": {
"tickPercent": -0.02,
"reservedAskPricePercent": 0.8
}
}
]
}
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 |
Status Reasons:
status | statusReason | 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_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 |