Sample API Calls for Travel Weather Insurance

In this insurance scenario, a travel insurance broker integrates with Riskwolf's APIs to offer a parametric travel weather insurance plan. This plan provides reimbursement for travelers who opt in during the online hotel booking process, specifically covering hotel costs in the event of rainy weather during their stay. As an example, consider a traveler booking a hotel in Mallorca from February 2, 2024, to February 6, 2024, with a rainfall trigger of 2.9mm between 10:00 and 18:00 each day, and a nightly hotel price of 100 EUR. The broker aims to seamlessly integrate with Riskwolf's APIs to assess available coverages, generate quotes based on the specified parameters, confirm policies for opted-in travelers, and subsequently evaluate and process claims in the event of qualifying weather conditions.

Detailed Technical Steps:

Coverage Assessment:

cURL Request:

     curl -X GET "https://tenant-mybroker.riskwolf.com/coverages?lat=xxx&long=yyy&time_range=2024-02-02T10:00:00Z/2024-02-06T18:00:00Z" -H "Authorization: Bearer YOUR_API_KEY"

Expected Return (Example):

     {
       "coverages": [
         {
           "id": "rainfall_coverage",
           "name": "Rainfall Coverage",
           "definition": "..."
         },
         // Additional coverages...
       ]
     }

Quote Generation:

cURL Request:

     curl -X POST "https://tenant-mybroker.riskwolf.com/quotes" -H "Authorization: Bearer YOUR_API_KEY" -d '{"coverage_id": "rainfall_coverage", "max_payout": 100, "qty": 4, "technical_client_ref": "Mallorca_booking"}'

Expected Return (Example):

     {
       "quote_id": "quote_123",
       "technical_rate": 2.5,
       "risk_price": 250
     }

Policy Confirmation:

cURL Request:

     curl -X POST "https://tenant-mybroker.riskwolf.com/policies" -H "Authorization: Bearer YOUR_API_KEY" -d '{"quote_id": "quote_123", "acceptance": true}'

Expected Return (Example):

     {
       "policy_id": "policy_456",
       "confirmation_message": "Policy accepted successfully."
     }

Claim Evaluation:

cURL Request:

     curl -X GET "https://tenant-mybroker.riskwolf.com/parametric-event?validated_day=2024-02-02" -H "Authorization: Bearer YOUR_API_KEY"

Expected Return (Example):

     {
       "validated_events": [
         {
           "policy_id": "policy_456",
           "event_type": "rainfall",
           "validated_day": "2024-02-02",
           "validated_amount": 3.5
         },
         // Additional events...
       ]
     }

These technical steps outline the integration process for the insurance broker, from assessing available coverages to generating quotes, confirming policies, and evaluating claims based on the specified parametric structures for travel weather insurance. The example focuses on the reimbursement of hotel costs due to rainy weather during the traveler's stay in Mallorca.