Lending
Purchasing a loan
6min
lending selling apis v2 cross river provides you (or your investor) three options to purchase your loans using the selling system (part of lending) recommended api and webhook integration for full automation and loan level monitoring as the loan moves from "pending" to "in seasoning" to "ready for purchase" to "purchased" low touch log in to the ui, review and click to purchase no touch auto debit your account with cross river regardless of the option, you can configure hooks to receive a purchase confirmation via email or slack holdforsale ("hfs") and long term hold for sale ("lthfs") are the loan types managed in selling you can also view loans that cross river retains ("ret") ui the sandbox ui is https //lendingappsandbox crbcos com/ loans/selling the production ui is https //lendingapp crbcos com/loans/selling api swagger https //lendingsandbox crbcos com/selling/swagger/index html https //lendingsandbox crbcos com/selling/swagger/index html url for sandbox https //lendingappsandbox crbcos com/loans/selling base url for production https //lendingapp crbcos com/loans/selling https //lendingapp crbcos com/loans/selling api scope for sandbox is coslending\ selling\ stg api scope for production is coslending\ selling\ prd important to access the links below you must have the following ip addresses allowlisted sandbox 66 206 202 39 , 66 206 202 12 production 66 206 202 62 , 66 206 202 15 api description purchasing a loan docid 6imq2qfpmcxv7oa4cceoa get all loans by loan type purchasing a loan docid 6imq2qfpmcxv7oa4cceoa purchase loans put/selling/api/loans/{id}/loantype request to change a loan type purchasing a loan docid 6imq2qfpmcxv7oa4cceoa get the latest sofr value get/selling/api/loans/{loantype} this api retrieves loan details based on loan type , which must be hfs, lthfs, or ret the loan type is specified in the url path (e g , /selling/api/loans/hfs) users can refine their search with multiple query parameters including issuing bank, investor, loan status, search filters, pagination controls, sorting options, and date filters (funding date, purchase date, seasoning start date, etc ) additionally, results can be exported as a csv file for easy data handling { "loans" \[ { "id" "735dfae0 c26a 4f75 9afa b26c00468706", "number" "00b153ef e8cb 4b76 aea7 c29879a69ad3", "originationstatus" "funded", "salestatus" "readyforpurchase", "mplid" "tst", "issuer" "crb", "originationid" "", "seasoningstart" "2025 01 21", "amount" 7001 8, "adjustedamount" 7000 5, "interestrate" 0 3, "interest" 4 02, "fees" 70 01, "total" 7075 83 }, post/selling/api/loans/purchase this api executes the purchase of loans based on loan type and purchase date the request body includes key details such as the date, loan type, (1 for hfs, 2 for lthfs), issuing bank, mpl id, and investor id (optional) the date parameter is required but does not impact the purchase process if the investor id is left empty, loans will be purchased without investor allocation for example purchase hfs loans for mpl tst for issuing bank crb when the purchase is complete, the user can receive a webhook "batchpurchasecomplete" get /selling/api/sofr this api returns the sofr 30 day average from the ny federal reserve this rate is needed if your contract with cross river is using sofr as the basis for interest accrual during the seasoning period