---
title: "Claim Status Webhook"
method: POST
path: "/webhooks/claims"
tags: ["Webhooks"]
---

# Claim Status Webhook

`POST /webhooks/claims`

Webhook endpoint documentation for claim status change notifications. This endpoint represents the structure of webhook payloads sent to your configured webhook URL when claim statuses change.

## Request body

- object — Webhook payload sent when claim status changes
  - `contractId` string — Contract identifier
  - `orderId` string — Order identifier
  - `claimId` string, required — Unique claim identifier
  - `claimType` 'extended_warranty' | 'shipping_protection' | 'category' | 'shipping_resolution' | 'return_resolution' | 'exchange_resolution', required — Type of claim
  - `claimStatus` 'approved' | 'denied' | 'review' | 'pending_adjudication' | 'fulfilled' | 'closed', required — Status of a claim
  - `transactionId` string, required — Transaction identifier
  - `remainingLimitOfLiability` number — Remaining limit of liability on the entitlement
  - `validationReason` string — Reason for validation if claim is in review
  - `coverageTerm` object — Coverage period details
    - `startDate` integer, required — Coverage start date (Unix timestamp)
    - `endDate` integer, required — Coverage end date (Unix timestamp)
  - `customer` object, required
    - `name` string, required — Customer's full name
    - `phone` string — Customer's phone number
    - `email` string, email, required — Customer's email address
    - `shippingAddress` object
      - `address1` string, required — Primary address line
      - `address2` string — Secondary address line
      - `city` string, required — City name
      - `countryCode` string, required — ISO country code
      - `postalCode` string, required — Postal/ZIP code
      - `provinceCode` string, required — Province/state code
  - `products` object[], required — Products associated with the claim
    - `referenceId` string, required — Product reference identifier
    - `lineItemId` string — Line item identifier
    - `limitOfLiability` object, required
      - `amount` number, required — Monetary amount
      - `currencyCode` string, required — ISO 4217 currency code
    - `title` string, required — Product title
    - `components` object[] — Product components
      - `referenceId` string, required — Component reference identifier
      - `productReferenceId` string, required — Parent product reference identifier
      - `value` object, required
        - `amount` number, required — Monetary amount
        - `currencyCode` string, required — ISO 4217 currency code
      - `title` string, required — Component title
    - `serialNumber` string — Product serial number
    - `selectedVariant` object
      - `referenceId` string — Variant reference identifier
      - `title` string — Variant title
      - `imageUrl` string, uri — Variant image URL
    - `imageUrl` string, uri — Product image URL
    - `type` string — Entitlement type
  - `incident` object, required — Incident details describing the failure
    - `FailureReasons` object[]
      - `lineItemId` string, required
      - `failureType` string, required
      - `failureCause` string, required
  - `reportedAt` integer, required — When the claim was reported (Unix timestamp)
  - `sendDate` integer, required — When the webhook was sent (Unix timestamp)
  - `type` 'claim_approved' | 'claim_denied' | 'claim_in_review', required — Type of webhook event
  - `url` string, uri, required — Webhook URL where this payload was sent
  - `kid` string, required — Key ID used for webhook signature verification
  - `denialReason` 'occurred_outside_coverage' | 'failure_not_covered' | 'police_report_not_provided' | 'images_not_provided' | 'under_manufacturer_warranty' | 'fraud_risk' | 'identity_verification_failed' — Reason for claim denial

## Response `200`

Webhook received and processed successfully

## Other responses

- `400` — Invalid webhook payload
- `401` — Webhook signature verification failed

---

[API](https://skmtc.dev/extend/apis/leads-api.md) · [All operations](https://skmtc.dev/extend/apis/leads-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/extend/leads-api/revisions/76403e33d7d6/schema)