Capvant

Submit a firm offer

post
https://sandbox.capvant.com/v1/deals/{ref}/firm-offer
POST
/deals/{ref}/firm-offer

Offered amount in the deal currency.

Defaults to the deal currency.

Number matching rate_type: APR percent, factor rate, or monthly interest percent.

Total fees in the offer currency.

When the offer lapses.

Conditions shown to the client alongside the figures.

Required only when the deal carries no statements: what you underwrote from instead (open banking, your own account data, an existing facility).

Binding terms after underwriting. The deal must carry bank statements (wait for request.fulfilled, or check statements.has_statements on the deal); if you underwrote from another source, send no_statements_reason. A firm offer supersedes your indicative offer on the same deal: the client sees one offer from you, marked firm, and firm figures outrank indicative ones in the comparison. Carry expires_at, since firm terms should have a validity date.

Authorization

ApiKeyAuth
X-API-Key<token>

Lender keys start with cv_live_; Partner keys start with cv_pk_. Shown once at creation, sent on every request.

In: header

Path Parameters

ref*string

The deal reference, e.g. CV93A41205. Case-insensitive.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Shell
curl -X POST "https://sandbox.capvant.com/deals/string/firm-offer" \  -H "Content-Type: application/json" \  -d '{    "amount": 0  }'
JSON
{  "offer_id": "string",  "maturity": "indicative",  "offer": {    "id": "string",    "amount": 0,    "currency": "GBP",    "kind": "string",    "maturity": "indicative",    "status": "string",    "created_at": "2019-08-24T14:15:22Z",    "superseded": true,    "superseded_at": "2019-08-24T14:15:22Z",    "superseded_by": "indicative",    "annual_rate_pct": 0,    "factor_rate": 0,    "term_months": 0,    "fees": 0,    "total_repayment": 0,    "expires_at": "2019-08-24T14:15:22Z",    "notes": "string"  },  "superseded": {    "maturity": "indicative",    "amount": 0,    "currency": "string",    "annual_rate_pct": 0,    "factor_rate": 0,    "monthly_interest_rate_pct": 0,    "term_months": 0,    "fees": 0,    "total_repayment": 0,    "expires_at": "2019-08-24T14:15:22Z",    "notes": "string",    "created_at": "2019-08-24T14:15:22Z",    "superseded_at": "2019-08-24T14:15:22Z",    "superseded_by": "indicative"  }}