Skip to main content
This file is generated by you and outlines the acceptance or rejection of the Sales Request file.
Lead offers two balance sheet models: Originate-to-Sell (OTS) and On-Sheet Lending (OSL). Under OTS, Lead sells receivables to the partner after the applicable hold period. Under OSL, Lead retains receivables on its own balance sheet through the loan’s terminal status rather than selling them.Sales Response files only contain entries for receivables designated as OTS. If the corresponding Sales Request contains no OTS receivables, the Sales Response will also be empty.
Ensure that the settlement_amount has been sent to the Operating Account prior to responding via Sales Response.
For all optional fields where you do not plan to pass through data, please include the header and an empty value.

​
Schema

FieldDescriptionRequiredData Type
sale_idLead-generated ID for sales of balancesRequiredstring
purchasing_entityThe legal name of the entity purchasing this receivableOptionalstring
responseenum
accepted
rejected		Requiredenum
accepted
rejected
reject_reasonDescription for rejection of the sale.Required if response = rejectedstring
generated_atThe day this file is generated. This should always be the date the file is sent to Lead Bank.Requireddatetime
ISO8601
effective_atThe timestamp of when the related object(s) were polled to collect the information for this record.Requireddatetime
ISO8601

​
Sandbox Behavior

In the first few days of Sandbox testing where you first begin creating loans, all loans will be within the “hold period” (i.e., still owned by Lead), meaning there will be no loans to be sold from Lead to you. During this period, Lead’s Sandbox environment generates empty Sales Request Files and posts them to your SFTP folder, beginning on Day 0. This facilitates testing of the end-to-end process. You are expected to send empty Sales Response Files during this period, also beginning on Day 0. This process continues until the hold period of the first loan(s) that you created ends, and a true “sale” is ready to be made from Lead to you, meaning the Sales Request File is populated with a loan record. If the first loan(s) created is on Day 1, then this typically occurs on Day 4. For any subsequent days where the Sales Request is empty (e.g., no loans were created in preceding days), you should continue to send empty Sales Response Files to complete the end-to-end Sandbox testing workflow. For OSL programs, no receivables will ever be designated as OTS, so Sales Request and Sales Response files will always be empty in both Sandbox and Production. This is expected behavior.