Skip to main content

Renew Policy

Renew a client’s policy on the platform. Clients will be notified in two months up to the expiry date. A client can renew a policy if it has already expired or about to expire. After the renewal, a new policy number is generated after renewal. The old policy is then marked as archived. In renewing the policy, the ID of the policy to be renewed is required.


The endpoint POST /api/v1/client/policies/{id}/renew allows you to renew the client's policy.

Headers

authorization : bearer token
sessionToken : client session token

Path param

NameRequiredDescriptionType
idRequiredID of the policy to be renewed. If the policy does not exist on the system, use /policies endpoint to create a new policy, with RENEWAL as the business type.string


Response

Example Success Response

Content type
application/json

[
{
"policyNo": "POL-0012",
"currency": "GHC",
"startDate": "2020-01-01T00:00:00.000Z",
"endDate": "2020-12-01T00:00:00.000Z",
"productId": "619c0911b46b424f5f3e470f",
"clientId": "619c0911b46b424f5f3e470f",
"originatingStaffId": "619c0911b46b424f5f3e470f",
"notes": "This is an auto insurance policy. It covers a car.",
"premium": 5000,
"exchangeRate": 1,
"businessType": "NEW_BUSINESS",
"businessCategory": "LOCAL",
"coverType": "COMPREHENSIVE",
"policyType": "AUTO",
"additionalInformation": {
"formSerialNumber": "AAFE123456789"
},
"assets": [
{}
]
}
...
]