The Analytics API lets you query the complete transaction history for your merchant account in Mexico 🇲🇽. Use it for reconciliation, reporting, and monitoring — with flexible query filters and paginated results. Two versions are available: Version Endpoint Coverage v1 GET /analytics/v1/transactions-listOnline card and payment transactions v2 GET /analytics/v2/transactions-listOnline and card-present transactions in a single endpoint
Use v2 for unified reporting
If your integration includes both Online Payments and Card Present (POS), use v2 to query all transaction types from a single endpoint.
Quick start# GET /analytics/v2/transactions-list?from=2026-05-01T00:00:00&to=2026-05-31T23:59:59&limit=50Parameter Required Description from✅ Start date — format YYYY-MM-DDTHH:MM:SS to✅ End date — format YYYY-MM-DDTHH:MM:SS limit— Max records per page. Default: 100 offset— Page offset for pagination
Query filters# Narrow results by adding any combination of query parameters: By transaction attributes# Parameter Description transaction_statusAPPROVAL, DECLINED, INITIALIZEDtransaction_typeSALE, CAPTURE, VOID, DEFERRED, PREAUTHORIZATION, REFUND, REVERSALpayment_methodcard, transfer, cash (v2 only) currency_codeMXNticket_numberExact ticket number lookup transaction_idKushki internal transaction ID approval_codeBank approval code response_codeProcessor response code
By card# Parameter Description card_typecredit, debitlast_four_digitsLast 4 digits of the card bin_cardCard BIN (first 6 digits) card_holder_nameCardholder name number_of_monthsInstallment months (MSI charges)
By amount# Parameter Description approved_transaction_amountApproved amount in MXN request_amountRequested amount subtotal_iva0Non-taxed subtotal subtotal_ivaTaxed subtotal
By merchant / processor# Parameter Description merchant_idFilter by specific merchant ID merchant_nameFilter by merchant name processor_idProcessor identifier processor_nameProcessor name subscription_idFilter by subscription ID external_reference_idMerchant-side transaction ID (v2 only)
Response structure# {
"total" : 1234 ,
"data" : [
{
"ticket_number" : "319228478889680318" ,
"transaction_id" : "6f16659e-b711-4995-a9ae-161aecbd6521" ,
"transaction_status" : "APPROVAL" ,
"transaction_type" : "SALE" ,
"payment_method" : "card" ,
"approved_transaction_amount" : 500 ,
"currency_code" : "MXN" ,
"card_type" : "credit" ,
"last_four_digits" : "4242" ,
"card_holder_name" : "Juan García" ,
"created" : 1748476800000
}
]
} Field Description totalTotal number of matching records dataArray of transaction objects for the current page createdUnix timestamp in milliseconds
Use limit and offset to page through large result sets: GET /analytics/v2/transactions-list
?from=2026-05-01T00:00:00
&to=2026-05-31T23:59:59
&limit=100
&offset=100limit: records per page (default 100)
offset: starting record index (0-based)
total in the response tells you the total number of matching records
Authentication# Using the API# https://api.kushkipagos.com/Available Endpoints#
Get Transactions List v1
Query online payment transactions with flexible date and attribute filters.
Get Transactions List v2
Unified query for online and card-present transactions. Recommended for all new integrations. Got a suggestion on this documentation? Contact us . 