Claim

Sample payloads for claim.success and claim.failed.

The claim events fire when an insurance claim you filed is approved or rejected.

claim.success and claim.failed are currently dispatched without a data object. The envelope arrives as { "event": "claim.success" } with no payload. Until this is corrected, treat the event as a signal and fetch the claim with Get Claim using the insurance_id you already hold.

What is delivered today

{
    "event": "claim.success"
}

The claim object

When the payload is populated, it carries the claim in the shape Get Claim returns. status is confirmed for claim.success and failed for claim.failed.

{
    "event": "claim.success",
    "data": {
        "claim_id": "CL-40756356455",
        "insurance": "IN-70732333028",
        "reason": "lost-in-transit",
        "description": "Package was lost in transit by DHL Express Courier in the United States",
        "status": "confirmed",
        "witnesses": [
            ["Adaeze Ukaegbu", "[phone]"],
            ["Augustus Obi", "[phone]"]
        ],
        "metadata": {
            "platform": "octamile",
            "reference": "cha54a60rgsacdz2",
            "insurance_reference": "ild52fsgkfs8uu3gr736ikl2fe9s93jn"
        },
        "created_at": "2026-09-16T21:21:29.302Z",
        "updated_at": "2026-09-19T08:12:03.441Z"
    }
}

The stored claim also holds a signature field containing a base64 image. It is large, and you should not rely on receiving it over a webhook.