Buying Cover

One call registers the policyholder, raises the quotation on the product's terms, opens the policy, puts the borrowers on cover, and — if you ask it to — collects the premium.

Your API key

Set it once and every Try it out below is authenticated. It stays in this browser's local storage and is never sent anywhere but the API.

Buy the cover

Reference →

POST/credit-life/onboard

Playground

Authorization

BearerAuth

Body

• Policyholder — send either clientId for one registered earlier, or a full client object to register a new one here. Exactly one of the two; both, or neither, returns 400.
• Borrowers — loans may be empty if you want to open the policy now and add borrowers later.
• Premium — payment is optional. Include it to buy cover up front (prepaid); leave it out if you remit to the insurer yourself or want to pay later. See Premium models.
• Idempotency-Key header — always send one. A retried request returns the original batch instead of covering the same borrowers twice.

The response carries the corporateClientId, the policy, the schedule — the batch and its premium — and payment if you sent a payment block.

See Policies and documents to find it again afterwards, or to open one on a quotation negotiated outside this one-shot flow.

Next: Premium models.