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

# Claim Status Webhook

`POST /webhooks/claims`

## Request

- Base URL: `https://api.helloextend.com`
- URL: `https://api.helloextend.com/webhooks/claims`
- Auth: none declared

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' | 'claim_closed', 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
  - `closedMetaData` object: Why and when the claim closed. Sent only on the claim_closed event.
    - `closedAt` number: Timestamp of when the claim was closed. NOTE - This field is formatted as a 13 digit Epoch timestamp.
    - `resolution` 'no_service' | 'service_change' | 'defective_product_not_shipped' | 'no_images_submitted' | 'identity_not_verified' | 'shipment_received' | 'no_service_required' | 'failure_not_covered' | 'resolved_with_alternative_method' | 'address_not_verified'
  - `closureMethod` 'automated' | 'system_auto_close' | 'extend_agent' | 'merchant_agent': Whether the closure was automatic or driven by an Extend or merchant agent. Sent only on the claim_closed event.

## Response `200`

Webhook received and processed successfully

## Other responses

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

---

[API](https://skmtc.dev/extend/apis/claims-management-api.md) - [All operations](https://skmtc.dev/extend/apis/claims-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/extend/apis/claims-management-api/revisions/24e670a19948?raw)