Enrol a batch of households
POST
/group-funeral/policies/{policyId}/members
Each member is a principal plus their beneficiaries (Spouse, Child, Parent), and each covered life is rated on its own age band. Straight-through: uploaded and approved in one call, which puts the households on risk. Approval does NOT collect money — the premium becomes due and is receipted separately as you remit, so cover starts while premium is still owed and outstandingPremium says how much. Approved, PartiallyReceipted or Receipted means covered; Pending means the batch was not approved and nobody is on risk.
Authorizations
BearerAuth
Type
HTTP (bearer)
Parameters
Path Parameters
policyId*
Type
Requiredstring
Request Body
application/json
JSON "members": [ { "fullName": "string", "nrcNumber": "string", "dateOfBirth": "string", "beneficiaries": [ { } ] } ], "currency": "string", "exchangeRate": 0, "midTermAddition": true
{
}
Responses
Success
application/json
JSON "id": "string", "number": "string", "status": "string", "type": "string", "totalMembers": 0, "netPremium": 0, "levy": 0, "grossPremium": 0, "amountReceipted": 0, "outstandingPremium": 0, "currency": "string", "createdAt": "string"
{
}