General Insurance

This guide covers issuing general insurance policies using the Inshuwa API.

Overview

General insurance covers non-motor, non-life, non-travel products such as property, fire, engineering, and liability insurance.

Workflow

1. Create a policyholder
2. Select a product
3. Issue the policy

Instant Issue

Issue a general insurance policy in a single step:

POST /api/v1/policies/instant/issue

Request body:

{
  "productId": "string",
  "quarters": 4,
  "currency": "ZMW",
  "startDate": "2024-01-01",
  "policyHolder": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@example.com",
    "phoneNumber": "260971234567"
  },
  "risks": []
}

Issue from Quotation

Issue a general policy from an existing quotation:

POST /api/v1/policies/{quoteId}/issue

Renew a Policy

Renew an existing general policy:

POST /api/v1/policies/{policyId}/renew

Request body:

{
  "startDate": "2025-01-01",
  "endDate": "2026-01-01"
}

View Policies

List all policies across all lines:

GET /api/v1/policies