---
title: "Update Claim"
method: POST
path: "/claim_update"
tags: ["Returns"]
---

# Update Claim

`POST /claim_update`

The /claim_update endpoint is used to update Riskified regarding the claim - specifically in regards to the return shipment back to the merchant. This endpoint will not trigger claim analysis. Riskified's acknowledgement response to this endpoint is returned synchronously.

## Headers

- `x-riskified-shop-domain` string, required
- `x-riskified-hmac-sha256` string, required
- `content_type` 'application/json', required
- `accept` 'application/vnd.riskified.com; version=2', required

## Request body

- ClaimUpdateRequest
  - `claim` ClaimUpdate
    - `id` string, required — The unique identifier for the claim.
    - `line_items` LineItemUpdate[], required — An array of line item objects, each one containing information about a unit of an item in the claim.
      - `order_id` string, required — The unique identifier for the order which is associated with the claim.
      - `sku` string, required — The sku of the item in the fulfillment.
      - `item_id` string — The unique identifier of the individual line item object in the claim/order.
      - `requested_action` 'store_credit' | 'refund' | 'reshipment' | 'exchange' | 'physical_gift_card' | 'none' — **(Conditional Requirement)** The action requested by the customer. The field is required to be provided either in /claim_create or in /claim_update.
      - `return_deadline` string, date-time — The date and time (ISO 8601) of the return deadline for the individual product.
      - `return_requested` boolean — States whether the item is expected to be returned back to the merchant.
      - `event_type` 'label_scan' | 'inspection', required — Where the item is in the claim/return lifecycle.
      - `return_shipping` ReturnShipping
        - `tracking_numbers` string, required — The return shipping number, provided by the shipping company.
        - `scanned_at` string, date-time — The date and time (ISO 8601) that the package was scanned (picked up) by the carrier.
        - `label_created_at` string, date-time — The date and time (ISO 8601) that the return shipping label was created.
        - `arrived_at` string, date-time — The date and time (ISO 8601) that the package has arrived to the store/warehouse.
        - `tracking_company` string — The name of the shipping company.
        - `weight` number, float — The package weight in grams or ounces.
        - `weight_unit` 'grams' | 'ounces' — The unit of measure for the weight.
        - `is_verified` boolean — Indication of whether the content of the box was physically inspected/verified at the time of scan.
        - `address` Address
          - `first_name` string, required — The first name of the person associated with the address.
          - `last_name` string, required — The last name of the person associated with the address.
          - `address1` string, required — The street name of the address.
          - `country` string, required — The name of the country address.
          - `country_code` string, required — The 2 letter country code (ISO 3166-1 alpha-2) of the country address.
          - `phone` string, required — The phone number at the address.
          - `city` string, required — The city of the address.
          - `zip` string, required — The zip or postal code of the address.
          - `address2` string — An optional additional field for the street address.
          - `company` string — **(Conditional Requirement)** Required if the address is associated to a company. The company of the person associated with the address.
          - `additional_phone` string — Additional phone number at the address.
          - `verified_phone` boolean — Indicates whether the provided phone number was verified.
          - `province` string, required — The name of the state or province of the address.
          - `province_code` string — The two-letter ISO 3166-2 alpha-2 code for the state or province of the address.
          - `neighborhood` string — The district or city division of the address. The neighborhood should be provided if used in a country’s official postal addresses. Examples of this include the Colonia in Mexico or Bairro in Brazil.
          - `latitude` number, float — The latitude coordinates of the address.
          - `longitude` number, float — The longitude coordinates of the address.
          - `id` string — **(Conditional Requirement)** unique ID, is required in case of multiple shipping addresses.
      - `inspection` Inspection
        - `condition` 'pristine' | 'second_quality' | 'poor' | 'fake' | 'missing' | 'valid_complaint', required — The condition of the item at time of inspection.
        - `external_condition` string — The condition of the item at time of inspection as recorded in the merchant's system.
        - `inspected_at` string, date-time, required — The date and time (ISO 8601) when the item was inspected.
        - `location` 'in_store' | 'warehouse' | 'third_party', required — The type of location where the item was inspected.
        - `location_id` string — The ID of the store/warehouse where the item was inspected.
        - `note` string — Free text or note added to claim as part of the inspection process.
    - `note` string — A note attached to the claim.

## Response `200`

Success

- ClaimUpdateResponse
  - `claim` ClaimOnlyId
    - `id` string — The unique identifier for the claim.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.dev/riskified/apis/chargeback-guarantee.md) · [All operations](https://skmtc.dev/riskified/apis/chargeback-guarantee/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riskified/chargeback-guarantee/revisions/2b7df5bce861/schema)