Travel Insurance

This guide walks you through issuing travel insurance policies using the Inshuwa API.

Overview

The travel insurance workflow:

1. Create a policyholder
2. Select a travel product and package
3. Generate a travel quotation
4. Pay and issue the policy
5. Download the policy certificate

Step 1: Create a Policyholder

Register the traveler:

POST /api/v1/policyholders/individuals

Step 2: Select a Travel Product

Browse travel insurance products:

GET /api/v1/products/travel

Each product contains packages with destination coverage, benefits, and premium amounts. Note the packageId.

Step 3: Create a Quotation

Generate a travel insurance quotation:

POST /api/v1/quotations/travel

Request body:

{
  "packageId": "string",
  "clientId": "string",
  "destination": "South Africa",
  "startDate": "2024-06-01",
  "policyHolder": {
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane@example.com",
    "phoneNumber": "260971234567"
  },
  "beneficiaries": []
}

Step 4: Issue the Policy

Issue the travel policy with payment:

POST /api/v1/quotations/{quoteId}/travel

Instant Issue (One Step)

Create, quote, and issue a travel policy with payment in one call:

POST /api/v1/quotations/travel/instant-issue

Step 5: Download the Certificate

GET /api/v1/quotations/{policyId}/travel/documents/certificate

Policy Renewal

Renew a travel policy with payment:

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

View Travel Policies

GET /api/v1/quotations/travel/policies
GET /api/v1/quotations/travel/policies/{policyId}