---
title: "Claim Decision"
method: POST
path: "/claim_decision"
tags: ["Returns"]
---

# Claim Decision

`POST /claim_decision`

The /claim_decision endpoint is used to complete the feedback loop and update Riskified on the final status of a claim. 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

- ClaimDecisionRequest
  - `claim` ClaimDecision
    - `id` string, required — The unique identifier for the claim.
    - `line_items` LineItemDecision[], required — An array of line item objects, each one containing information about 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.
      - `claim_reason` 'not_received' | 'missing_item' | 'wrong_item' | 'damaged' | 'customer_preference' | 'other' | 'valid_complaint' — The reason a refund/return is being claimed.
      - `orig_claim_reason` string — The original claim reason of the merchant.
      - `decision` Decision
        - `decision` 'approve' | 'decline' | 'review' | 'cancel', required — The result/decision of the claim.
        - `decided_at` string, date-time, required — The date and time (ISO 8601) that the final decision on the claim was made.
        - `decision_reason` 'manual_review' | 'successful_delivery' | 'chargeback' | 'business_policy' | 'riskified' | 'valid_complaint' — The reason for the claim decision.
        - `refund_amount` number, float — The dollar amount that was refunded back to the customer, or cost of item that was reshipped.
        - `action` 'store_credit' | 'refund' | 'reshipment' | 'exchange' | 'physical_gift_card' | 'none' — The action by the merchant to appease the claim.
        - `decided_by` string — The person/organization that decided on the claim.
    - `handling_fee` number, float — Sum of any fees (i.e., handling or restocking fee, etc.) that was applied to the claim.
    - `note` string — A note attached to the claim/decision.

## Response `200`

Success

- ClaimDecisionResponse
  - `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)