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

# View chargebacks

`GET /chargeback/v3`

## Request

- Base URL: `https://api.nexiopaysandbox.com`
- URL: `https://api.nexiopaysandbox.com/chargeback/v3`
- Auth: HTTP basic

Returns all chargebacks within the given date range for all merchant IDs associated with the Nexio account used to [authenticate](doc: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](doc: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](doc: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](doc: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](doc:common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/reporting-api-reference.md) - [All operations](https://skmtc.dev/nexiopay/apis/reporting-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/nexiopay/apis/reporting-api-reference/revisions/3361e7e0624b?raw)