Select an Offer

Report which of the approved offers your customer chose. Once Tento publishes the terms, the application moves to Approved and loanRequest.offers[] (GET /financing/application/{id}, and the loan_application.stage_changed / loan_application.updated webhooks) lists the offers with their requiredDocuments. Show them to your customer, then send the chosen offer's id here as offer_id.

After a successful call the application carries loanRequest.selectedOffer, Tento's team is notified and prepares the paperwork, and a loan_application.updated webhook is sent with changedFields: ["offers", "selectedOffer"]. Upload the selected offer's requiredDocuments with POST /financing/upload-files. The rest of the journey arrives as loan_application.stage_changed webhooks: DocsOut (contract sent for signature), DocsIn (signed), Funded.

The call is safe to retry: selecting the offer that is already selected answers 200 with changed: false. Selecting a different offer after one was chosen is refused (409 OFFER_ALREADY_SELECTED) — contact Tento to change the terms. Offers can only be selected while the application is Approved (409 APPLICATION_NOT_APPROVED otherwise). Requires the send-loan-application permission; a read-only token cannot select.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Application identifier (Tento public ID or external partner-assigned ID)

Query Params
string
enum
Defaults to tento

Type of ID provided: 'tento' for Tento public ID (default) or 'external-partner-assigned' for your custom ID

Allowed:
Body Params
string
required

id of one of the application's loanRequest.offers[].

Headers
string
required

Your tento Partner API Key with send-loan-application permission

Responses

429

Rate limit exceeded (120 requests per minute per client IP).

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json