Query Chargebacks

Developing

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Successful query

application/json

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

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "0c2dac27-ba93-4d82-86ec-fd960186cb5e",
            "chargeback_ticket_code": "1770146347760977",
            "merchant_name": "AGREGADOR",
            "chargeback_status": "INITIALIZED",
            "reason_code": "4834",
            "request_amount": 2325.3,
            "currency_code": "PEN",
            "transaction_date": "2019-08-24T14:15:22.123Z",
            "request_date": "2019-08-24T14:15:22.123Z",
            "deadline_representation_date": "2019-08-24T14:15:22.123Z",
            "deadline_resolution_date": "2019-08-24T14:15:22.123Z",
            "risk_level": "HIGH",
            "ticket_code": "string",
            "operation_id": "string",
            "transaction_reference": "string",
            "merchant_code": "string",
            "business_unit": "string",
            "approved_transaction_amount": 0,
            "transaction_type": "string",
            "transaction_status": "string",
            "chargeback_type": "ADMINISTRATIVE",
            "reason_description": "string",
            "notification_status": "string",
            "documentation_reception_date": "2019-08-24T14:15:22.123Z",
            "execution_date": "2019-08-24T14:15:22.123Z",
            "issuing_delivery_date": "2019-08-24T14:15:22.123Z",
            "create_timestamp": "2019-08-24T14:15:22.123Z",
            "update_timestamp": "2019-08-24T14:15:22.123Z",
            "processor_name": "string",
            "issuing_bank": "string",
            "card_country_name": "MEXICO",
            "country_name": "MEXICO",
            "security_service": "string",
            "security_message": "string",
            "masked_credit_card": "string",
            "last_four_digit_code": "string",
            "source": "string"
        }
    ],
    "page": 1,
    "page_size": 20,
    "total": 19990,
    "total_pages": 1000
}

Modified at 2026-08-03 20:38:31

Chargebacks

Request Chargeback Export

Query Chargebacks

Filters object#

Time Filter#

Fields array#

Request

Responses

Filters object

Time Filter

Fields array