---
title: "Chargeback: List"
method: GET
path: "/chargeback_requests"
tags: ["Chargebacks"]
---

# Chargeback: List

`GET /chargeback_requests`

Retrieves a paginated list of chargeback requests for the authenticated merchant.

Results are ordered with `pending` chargebacks first, followed by non-pending
chargebacks. There is no request sort parameter.

This endpoint is only available to merchants with the chargeback feature
enabled; otherwise it returns `404 Not Found`.

## Query parameters

- `start_time` string, date-time
- `end_time` string, date-time
- `per_page` integer
- `page` integer
- `status` 'pending' | 'accepted' | 'cancelled' | 'expired' | 'defended' | 'lost' — Current status of a chargeback request.
- `payment_id` string
- `due_date_start` string, date-time
- `due_date_end` string, date-time

## Response `200`

200 response

- ChargebackRequestList
  - `resource` string, required — Resource type name, always "list".
  - `data` ChargebackRequestListItem[], required — Array of chargeback request objects for this page.
    - `id` string, required — A unique 25-character alphanumeric resource identifier.
    - `payment_id` string, required — A unique 25-character alphanumeric resource identifier.
    - `amount` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
    - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.
    - `payment_method` ChargebackPaymentMethod, required — Summary of the payment method associated with a chargeback.
      - `type` string, required — Payment method type slug (e.g. "credit_card").
      - `brand` string, nullable, required — Card brand, or null if not applicable.
      - `last_four_digits` string, nullable, required — Last four digits of the card, or null if not applicable.
    - `reason_code` string, required — Machine-readable reason code. Internal codes (e.g. "CB_Fraud") are used by default; for Worldpay Visa/Mastercard payments the network's own reason codes are used instead (e.g. "10.4" or "4837").
    - `reason` string, required — Human-readable chargeback reason corresponding to the reason code.
    - `created_at` string, date-time, required — Timestamp when the chargeback was created.
    - `due_date` string, date-time, required — Deadline by which the merchant must respond.
    - `status` 'pending' | 'accepted' | 'cancelled' | 'expired' | 'defended' | 'lost', required — Current status of a chargeback request.
  - `start_time` string, date-time, required — Start of the time range for records in this response.
  - `end_time` string, date-time, required — End of the time range for records in this response.
  - `total` integer, required — Total number of records matching the query.
  - `page` integer, required — Current page number.
  - `per_page` integer, required — Number of results per page.
  - `last_page` integer, required — Last available page number.

## Other responses

- `401` — Authentication failed
- `404` — Chargeback feature is disabled for the merchant

---

[API](https://skmtc.net/komoju/apis/komoju-api.md) · [All operations](https://skmtc.net/komoju/apis/komoju-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komoju/komoju-api/revisions/65483c40ba32/schema)