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

# Claim Decision

`POST /claim_decision`

## Request

- Base URL: `https://api-sandbox.riskified.com/policy/v2`
- URL: `https://api-sandbox.riskified.com/policy/v2/claim_decision`
- Auth: none declared. Required headers: `x-riskified-shop-domain`, `x-riskified-hmac-sha256`, `content_type`, `accept`

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/policy-protect-refunds-returns.md) - [All operations](https://skmtc.dev/riskified/apis/policy-protect-refunds-returns/llms.txt) - [OpenAPI document](https://skmtc.dev/riskified/apis/policy-protect-refunds-returns/revisions/1b2c88304179?raw)