---
title: "View chargebacks"
method: GET
path: "/chargeback/v3"
tags: ["Chargebacks"]
---

# View chargebacks

`GET /chargeback/v3`

Returns all chargebacks within the given date range for all merchant IDs associated with the Nexio account used to [authenticate](https://docs.nexiopay.com/docs/authentication). You may also request or filter on fields of the query parameters, as in the following example:

  <code>/chargeback/v3?kount.&plugin.&customer.&processor.&gateway.</code>
  
See the [query parameters](https://docs.nexiopay.com/docs/filtering-using-query-parameters) section in Guides for a full tutorial.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).


<div style="display:none;">

## Request parameters
- endDate
- limit
- offset
- startDate

## Response parameters
- offset
- limit
- rows
- rows.id
- rows.relatedChargebackId
- rows.merchantId
- rows.reportDate
- rows.sequenceNumber
- rows.cardType
- rows.cardNumber
- rows.amount
- rows.transactionDate
- rows.reasonCode
- rows.description
- rows.referenceNumber
- rows.message
- rows.authCode
- rows.lockBoxBatch
- rows.cardIdentifier
- rows.transactionCode
- rows.transactionId
- rows.transactionRef
- rows.chargebackCycle
- rows.isDisputed
- rows.achId
- rows.achDetailsId
- rows.currencyId
- rows.emailSentDate
- rows.createdAt
- rows.updatedAt
- hasMore

</div>

## Query parameters

- `limit` integer
- `offset` integer
- `startDate` string
- `endDate` string

## Response `200`

Success

- object
  - `offset` integer — The number of rows by which the data is offset.
  - `limit` integer — The limit on the number of rows.
  - `rows` object[] — An array of chargebacks
    - `id` integer — The Nexio chargeback ID. This is a unique value.
    - `relatedChargebackId` integer — An ID of a related chargeback, if applicable. This value comes from the chargeback department.
    - `merchantId` string
    - `reportDate` string, date-time
    - `sequenceNumber` string
    - `cardType` string
    - `cardNumber` string
    - `amount` number — The chargeback amount claimed by the customer.
    - `transactionDate` string, date-time
    - `reasonCode` string
    - `description` string
    - `referenceNumber` string
    - `message` string
    - `authCode` string
    - `lockBoxBatch` string
    - `cardIdentifier` string
    - `transactionCode` string
    - `transactionId` integer
    - `transactionRef` string
    - `chargebackCycle` 0 | 1 | 2 | 3 | 3.1 | 3.2 | 4 | 4.1, float — The chargeback cycle number. For information about what each value means, see the [chargebackCycle](https://docs.nexiopay.com/docs/constant-transaction-values#chargeback-cycle-chargebackcycle) table in Guides.
    - `isDisputed` boolean
    - `achId` string
    - `achDetailsId` AchDetailsId — unresolved $ref
    - `currencyId` string
    - `emailSentDate` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `hasMore` boolean — Will be `true` if there are more records not included in the current response.

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)