Skip to content

Renewals

Some policies run in repeating cover periods rather than once to an end date. For those, check whether cover is in force and pay any outstanding periods.

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.

Is cover in force?
Reference →
GET/credit-life/policies/{policyId}/status

Playground

Authorization
Variables
Key
Value

Before opening a period, preview what renewing would cost — same response shape as status, and it writes nothing, so call it as often as you like:

Quote the renewal
Reference →
POST/credit-life/policies/{policyId}/renew/premiums

Playground

Authorization
Variables
Key
Value
Pay the periods the policy owes
Reference →
POST/credit-life/policies/{policyId}/renew

Playground

Authorization
Variables
Key
Value

status returns Active, InGrace or Lapsed. Reinstatement is forward-only: paying arrears restores cover from now, and losses that arose while the policy was lapsed stay uncovered.

renewCreditLifeCover does not itself collect money — it opens every outstanding period, and each one goes on risk immediately unless the policy is prepaid, in which case it stays pending until paid. To open the current period and pay for it in the same call:

Renew and pay the current period in one call
Reference →
POST/credit-life/policies/{policyId}/renew/pay

Playground

Authorization
Variables
Key
Value
Body

That settles one period at a time — a policy with arrears spanning more than one period rejects it, and each is paid individually via payCreditLifePremium instead.

To carry the policy's outstanding loans into a new cover period rather than only settling arrears:

Renew, carrying the outstanding loans over
Reference →
POST/credit-life/policies/{policyId}/renew/loans

Playground

Authorization
Variables
Key
Value
Body

On a prepaid policy, renew and pay for the new period together:

Renew and pay in one call
Reference →
POST/credit-life/policies/{policyId}/renew/loans/pay

Playground

Authorization
Variables
Key
Value
Body

Next: Early settlement.

Built with ❤️ by Hobbiton Technologies