Skip to main content
GET
List chargebacks

Authorizations

Authorization
string
header
required

Bearer credential for the public API: a live COPE API key (ck_live_*; keys issued earlier as cope_sk_live_* keep working). Dashboard sign-in tokens are not accepted.

Query Parameters

created_from
string

Inclusive lower bound on created_at, ISO 8601. A bare date (YYYY-MM-DD) expands to the beginning of that day in UTC; a full date-time is used as given, and timezone-naive values are interpreted as UTC.

created_to
string

Inclusive upper bound on created_at, ISO 8601. A bare date (YYYY-MM-DD) expands to the end of that day in UTC; a full date-time is used as given, and timezone-naive values are interpreted as UTC.

payment_method
string

Which payment methods to return: one name or several separated by commas (card,sepa). The names are the values payment_method carries: card, klarna, affirm, sepa, ach, afterpay_clearpay, paypal, terminal, other, interac_present, kr_card, alma, billie, scalapay, sequra, sunbit, zip, acss_debit, au_becs_debit, bacs_debit, nz_bank_account, payto, ideal, bancontact, eps, fpx, giropay, p24, sofort, pay_by_bank, link, amazon_pay, cashapp, alipay, wechat_pay, grabpay, revolut_pay, mobilepay, twint, satispay, bizum, mb_way, kakao_pay, naver_pay, payco, samsung_pay, paypay, swish, blik, paynow, pix, promptpay, upi, boleto, konbini, multibanco, oxxo, crypto, customer_balance, stripe_balance. Without it every payment method is returned. An unknown name or an empty element is refused with 422.

status
string

Which statuses to return: pending, succeeded, failed, or several separated by commas. Without it every status is returned. An unknown name or an empty element is refused with 422.

type
string

Which rows to return: chargeback, chargeback_reversal, or both separated by a comma. Without it both are returned. A chargeback_reversal returns a chargeback's money to you when the dispute is won; its amount_cents is positive. An unknown name or an empty element is refused with 422.

page
integer

Page number for paginated results. Values below 1 and non-numeric values are ignored and the first page is returned; a page past the last one returns the last page. current_page is accepted as an older name for it and wins when both are sent.

Required range: x >= 1
per_page
integer

Number of records per page. Defaults to 12; values above 25 are clamped to 25; values below 1 and non-numeric values are ignored and the default is used. items and limit are accepted as older names for it, read only when per_page is absent.

Required range: 1 <= x <= 25

Response

Successful response

data
object[]
required
pagination
object
required