Query chargebacks

POST

/data/v1/chargebacks/search

Returns a paginated list of chargebacks associated with the authenticated merchant.

Filters object

Use the filters object to narrow results by transaction_date, request_date, chargeback_status, country_name, chargeback_type, ticket_code, or chargeback_ticket_code.

Time Filter

The time filter is required and works as follows:

Send either transaction_date or request_date

Sending both returns an error.

The maximum allowed date window is 3 months.

Fields array

The fields array allows you to request additional fields beyond the default response set. If fields is omitted, only the standard fields are returned.

Limit: The maximum allowed value for page_size in this version is 100 records per page.

Request

Authorization

API Key

Add parameter in header

private-merchant-id

Example:

private-merchant-id: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful query. Returns the paginated list of chargebacks matching the applied filters.

Body

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

Query with default fieldsQuery with filters and additional fields

curl --location --request POST 'https://api-uat.kushkipagos.com/data/v1/chargebacks/search' \
--header 'private-merchant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filters": {
        "time": {
            "transaction_date": {
                "from": "2026-02-01",
                "to": "2026-02-28"
            }
        }
    },
    "pagination": {
        "page": 1,
        "page_size": 20
    }
}'

Response Example

200 - default

{
    "data": [
        {
            "id": "0c2dac27-ba93-4d82-86ec-fd960186cb5e",
            "chargeback_ticket_code": "1770146347760977",
            "merchant_name": "MI COMERCIO EC",
            "chargeback_status": "INITIALIZED",
            "reason_code": "4834",
            "request_amount": 150,
            "currency_code": "USD",
            "transaction_date": "2026-01-08T22:24:09.611Z",
            "request_date": "2026-02-01T00:00:00Z",
            "deadline_representation_date": "2026-02-15T00:00:00Z",
            "deadline_resolution_date": "2026-06-01T00:00:00Z",
            "risk_level": "MEDIUM"
        },
        {
            "id": "1a3ebc38-cd04-5e93-97fd-ge071297dc6f",
            "chargeback_ticket_code": "1770146347359650",
            "merchant_name": "MI COMERCIO EC",
            "chargeback_status": "INITIALIZED",
            "reason_code": "4853",
            "request_amount": 320.5,
            "currency_code": "USD",
            "transaction_date": "2025-11-15T01:16:42.015Z",
            "request_date": "2026-02-01T00:00:00Z",
            "deadline_representation_date": "2026-02-15T00:00:00Z",
            "deadline_resolution_date": "2026-06-01T00:00:00Z",
            "risk_level": "MEDIUM"
        }
    ],
    "page": 1,
    "page_size": 20,
    "total": 42,
    "total_pages": 3
}

Modified at 2026-04-15 21:33:25

Overview

Request chargeback export

Query chargebacks

Filters object#

Time Filter#

Fields array#

Request

Responses

Filters object

Time Filter

Fields array