Submit Order

This subresource allows investors to submit a new order for one or more loans.

Operation: POST

URL: https://api.lendingclub.com/api/investor/<version>/accounts/<investor id>/orders

URL Parameters: Investor Id — This can be obtained from the Account Summary section on Lending Club website when a user is logged in.

Query Parameters: None.

Supported Formats: JSON

Request Payload: JSON request for submit order

Name Type Nullable Description
aid integer No The id of the investor account
loanId integer No Unique LC assigned id for the loan. This is the same as the id loan attribute returned in the loanListing result of the LoanBrowseLoans operation.
requestedAmount BigDecimal No Amount to be invested in this loan
portfolioId integer Yes Unique LC assigned id for the portfolio which this note should be assigned if the order is submitted successfully.

Sample request —

{
	"aid":11111,
	"orders":[
	{
		"loanId":22222,
		"requestedAmount":55.0,
		"portfolioId":44444
	},
	{
		"loanId": 33333,
		"requestedAmount":25,
		"portfolioId":55555
	},
	{
		"loanId": 44444,
		"requestedAmount":25,
	}]
}

Returned value: Successful or partially successful execution of the call will result in a JSON response. Cases where the input is invalid (ex. Wrong loan id or trying for loan which is not permitted for the investor) will result in a HTTP Response code 400 (Bad Request)

Any validation problems (ex. Loan no longer in funding or requested amount not a multiple of 25) will be returned via a JSON response with the appropriate execution status.

Name Type Nullable Description
orderInstructId integer No A unique LC assigned id identifying the OrderInstruct.
loanId integer No Unique LC assigned id for the loan. This is the same as the id loan attribute returned in the LoanListing result of the LoanBrowseLoans operation.
requestedAmount BigDecimal No Amount that was requested for investment in this loan.
investedAmount integer No Actual amount that was invested in this loan.
executionStatus String No Indicates the status of the execution.

Explanation of order outcome by the "execution-status" attribute:

Execution status Invested Amount Description
ORDER_FULFILLED = Requested Order fulfilled as submitted. Invested amount is equal the requested amount.
LOAN_AMNT_EXCEEDED < Requested Order fulfilled up to the remaining loan funding amount.
NOT_AN_INFUNDING_LOAN = 0 Order ignored, loan does not exist or is not in funding.
REQUESTED_AMNT_LOW = 0 Order ignored. For normal loans: Requested amount is smaller than $25 and is or becomes $0 when rounded. For whole loans: Requested amount is less that the entire loan amount.
REQUESTED_AMNT_ROUNDED < Requested Order fulfilled up to the highest $25 multiple smaller than requested amount. This happens when the requested amount is not a multiple of $25.
AUGMENTED_BY_MERGE > Requested Order augmented by merging other orders in the instruct that were targeting the same loan. Since other restrictions may apply after merging the presence of other status should be checked and the invested amount will not necessarily be the total requested for the loan.
ELIM_BY_MERGE = 0 Order ignored and merged into a previous order in the same instruct. This happens when there are more than one orders for the same loan.
INSUFFICIENT_CASH = 0 Order was ignored since there was not enough cash available.
NOT_AN_INVESTOR = 0 Order was ignored since user credentials do not match an investor.
NOT_A_VALID_INVESTMENT = 0 Order ignored. User does not have the required permissions to invest or because his previous order was still being processed.
NOTE_ADDED_TO_PORTFOLIO = Requested This indicates that the successful order was assigned to the portfolioId passed in the request. This status does not indicate the amount invested.
NOT_A_VALID_PORTFOLIO = Requested This indicates that the order was not assigned to the indicated portfolioId from the request.
ERROR_ADDING_NOTE_TO_PORTFOLIO = Requested This indicates that there was an error adding the note to requested portfolio.
SYSTEM_BUSY = 0 Order was ignored due to other system activity.
UNKNOWN_ERROR = 0 Order was ignored due to an unknown error.

Sample Successful response —

{
	"orderInstructId":55555,
	"orderConfirmations": [
	{
		"loanId":22222,
		"requestedAmount":55.0,
		"investedAmount":50.0,
		"executionStatus":
			[
			"REQUESTED_AMOUNT_ROUNDED",
			"ORDER_FULFILLED"
			]
	},
	{
		"loanId":33333,
		"requestedAmount":25.0,
		"investedAmount":25.0,
		"executionStatus":
			[
			"ORDER_FULFILLED"
			]
	},
	{
		"loanId":44444,
		"requestedAmount":25.0,
		"investedAmount":0,
		"executionStatus":
			[
			"NOT_AN_INFUNDING_LOAN"
			]
	}]
}