---
title: "List Claims"
method: GET
path: "/claim-management/partner/v1/claims"
tags: ["Dispute Management"]
---

# List Claims

`GET /claim-management/partner/v1/claims`

## Request

- Base URL: `https://api-sandbox.tamara.co`
- URL: `https://api-sandbox.tamara.co/claim-management/partner/v1/claims`
- Auth: HTTP bearer

This API lets you list all the claims on your account.

## Query parameters

- `order_id` string
- `order_reference_id` string
- `claim_id` integer
- `status` string[]
- `created_from` string, date-time
- `created_to` string, date-time
- `updated_from` string, date-time
- `updated_to` string, date-time
- `page` integer
- `limit` integer
- `sort` 'asc' | 'desc'

## Response `200`

Claims found

- object
  - `action_required` integer: Claims awaiting merchant action
  - `static_opened_cases` integer: Claims under review
  - `total` integer: Total matching filters
  - `data` object[]: Claims on this page
    - `claim_id` integer: Claim ID
    - `consumer` object: Customer
      - `full_name` string: "" when unknown
      - `first_name` string: "" when unknown
      - `last_name` string: "" when unknown
      - `email` string: Always masked
      - `phone_number` string: Readable while open/under_review; masked after
      - `national_id` string: Always masked
      - `date_of_birth` string, date
    - `claim_created_at` string, date-time
    - `claim_amount` object: Claim amount
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `currency` 'SAR' | 'AED': Claim currency (ISO 4217)
    - `branch` string: Order store code; "" when not set
    - `claim_reason` string
    - `claim_sla` string: SLA days as string, e.g. "10"
    - `claim_status` string: Merchant-facing status open - Awaiting merchant action under_review - With Tamara, or awaiting further merchant settlement on a partial settlement closed - Resolved: accepted, rejected, or otherwise closed cancelled - Cancelled
    - `sub_status` string: Outcome sub-status; "" when none accepted_by_merchant rejected_by_merchant refunded_from_tamara refunded_from_merchant ""
    - `order_id` string: Tamara order_id
    - `order_reference_id` string: Merchant_order_reference_id; "" when unknown
    - `order_number` string: Merchant_order_number; "" when unknown
    - `order_total_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `order_captured_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `order_refunded_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `order_canceled_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `order_tax_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `order_discounted_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `order_shipment_amount` object: Null only if order record unavailable
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `merchant_id` string: Merchant ID (UUID format); "" when unknown
    - `merchant_name` string
    - `merchant_country` string: "" when unknown
    - `order_instalments` integer
    - `order_payment_type` string: E.g. PAY_BY_INSTALMENTS; "" when unknown
    - `order_billing_address` object
      - `country_code` string
      - `city` string
      - `first_name` string
      - `last_name` string
      - `line1` string
      - `line2` string
      - `postal_code` string
      - `region` string
      - `phone_number` string: Same masking rule as consumer.phone_number
    - `claim_refunded_amount` object: Refunded against this claim (not order total)
      - `amount` number
      - `currency` 'SAR' | 'AED'
    - `sla_days_left` integer: 0 when expired or settled
    - `resolution` string
    - `accepted_by` string: merchant, tamara, or null
    - `refunded_from` string: merchant, tamara, or null
    - `current_stage_age` object
      - `since` string, date-time: When current status began
      - `seconds` integer: Seconds since since
  - `tab_aggregations` object: Tab counts
    - `total_all_cases` number: Sum of tab counts
    - `total_action_required` integer: open
    - `total_under_review` integer: under_review
    - `total_closed` integer: closed + cancelled

## Other responses

- `404`

---

[API](https://skmtc.dev/tamara/apis/claim-management-apis.md) - [All operations](https://skmtc.dev/tamara/apis/claim-management-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/tamara/apis/claim-management-apis/revisions/1a7681bc5c4b?raw)