---
title: "List settlement chargebacks"
method: GET
path: "/settlements/{settlementId}/chargebacks"
tags: ["Settlements API"]
---

# List settlement chargebacks

`GET /settlements/{settlementId}/chargebacks`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/settlements/{settlementId}/chargebacks`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `settlements.read`, `payments.read`

Retrieve all chargebacks 'deducted' from the given settlement.

The response is in the same format as the response of the [List chargebacks endpoint](list-chargebacks).

> 🔑 Access with
>
> [Advanced access token with **settlements.read** **payments.read**](/reference/authentication)
>
> [OAuth access with **settlements.read** **payments.read**](/reference/authentication)

## Query parameters

- `from` string
- `limit` integer, nullable
- `embed` 'payment'
- `testmode` boolean

## Response `200`

A list of chargeback objects.

- object
  - `count` integer, required: The number of items in this result set. If more items are available, a `_links.next` URL will be present in the result as well. The maximum number of items per result set is controlled by the `limit` property provided in the request. The default limit is 50 items.
  - `_embedded` object, required
    - `chargebacks` object[], required: A list of chargeback objects.
      - `resource` string, required: Indicates the response contains a chargeback object. Will always contain the string `chargeback` for this endpoint.
      - `id` string, required: The identifier uniquely referring to this chargeback. Example: `chb_n9z0tp`.
      - `amount` object, required: The amount charged back by the customer.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `settlementAmount` object, nullable: The amount deducted from your account balance for this chargeback, converted to the currency your account is settled in. Always a **negative** amount.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `reason` object, nullable: Reason for the chargeback as given by the bank. Only available for chargebacks of SEPA Direct Debit payments.
        - `code` string, required: Technical code provided by the bank.
        - `description` string, required: A more detailed human-friendly description.
      - `paymentId` string, required: The unique identifier of the payment this chargeback was created for. For example: `tr_5B8cwPMGnU6qLbRvo7qEZo`. The full payment object can be retrieved via the payment URL in the `_links` object.
      - `settlementId` string, nullable: The identifier referring to the settlement this payment was settled with. For example, `stl_BkEjN2eBb`. This field is omitted if the refund is not settled (yet).
      - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      - `reversedAt` string, nullable: The date and time the chargeback was reversed if applicable, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
        - `self` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
          - `href` string, required: The actual URL string.
          - `type` string, required: The content type of the page or endpoint the URL points to.
        - `payment` object, required: The API resource URL of the [payment](get-payment) that this chargeback belongs to.
          - `href` string, required: The actual URL string.
          - `type` string, required: The content type of the page or endpoint the URL points to.
        - `settlement` object, nullable: The API resource URL of the [settlement](get-settlement) this chargeback has been settled with. Not present if not yet settled.
          - `href` string: The actual URL string.
          - `type` string: The content type of the page or endpoint the URL points to.
      - `mode` string: Whether this entity was created in live mode or in test mode. Settlements are always in live mode. Possible values: `live`
  - `_links` object, required: Links to help navigate through the lists of items. Every URL object will contain an `href` and a `type` field.
    - `self` object, required: The URL to the current set of items.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `previous` object, nullable, required: The previous set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `next` object, nullable, required: The next set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `400`: The request contains issues. For example, if the specified `from` value is not a valid ID.
- `404`: No entity with this ID exists.
- `429`: Rate Limit has been reached.

---

[API](https://skmtc.dev/mollie/apis/business-operations.md) - [All operations](https://skmtc.dev/mollie/apis/business-operations/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/business-operations/revisions/d51d76f4e5d9?raw)