1. Analytics
  • API Docs Peru 🇵🇪
  • Online Payments
    • Release Notes
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Preauthorization (tokenless)
      • Create payment (tokenless)
      • Void a transaction
      • Refund a transaction
      • Verify Account
      • Request deferred options
      • Authorize payments
      • Reauthorize payments
      • Capture an authorized payment
      • Validate OTP
      • Bin Info V2
      • Bin Info
    • One-Click & Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Update recurring charge card data
      • Make an One-click payment
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Authorize payments
      • Capture an authorized payment
      • Get recurring charge Info
    • Card Out
      • Get Card Payout Token
      • Get Subscription Token
      • Push funds
      • Push Funds in subscriptions
      • Get transaction status
      • Delete Subscription
    • Transfer In
      • Get Bank List
      • Request a Transfer In token
      • Init Transaction
      • Get Status
    • Transfer Out
      • Get Bank List
      • Get Bank List V2
      • Request a Transfer Out token
      • Init Transaction
      • Get Status
      • Balance for Payouts
    • Cash In
      • Request a cash in token
      • Init Transaction
      • Transaction Status
    • Smartlinks V2
      • Create a Smartlink
      • Update a Smartlink
      • Get a Smartlink
      • Delete a smartlink
    • Analytics
      • Get transactions list v1
        GET
      • Get transactions list v2
        GET
    • Chargebacks
      • Query chargebacks
      • Request chargeback export
    • Gateway Status
      • Get gateway status
    • Payment Credentials
      • Create a credential
      • Search credentials
      • Advanced search
      • Activate or deactivate
      • Delete credential
      • Update credential
      • Regenerate a credential
    • Payment Button
      • Create a payment button
    • Platform Status
      • Get platform status
    • Subscription Transactions
      • Get subscription transactions
    • Settlement
      • Query settlement
  • Card Present Payments (API Raw)
    • Release notes
    • Key Exchange Process
    • Test data
    • Kushki Error Catalog for POS transactions
    • The Amount Object
    • One-time Payments
      • Single payment
    • Two-step Payments
      • Authorization and capture
    • Voids & Refunds
      • Refund a transaction
      • Void & Reverse
    • Card information
      • Get BIN Info
      • Bin Info V2
      • Request deferred options
      • Balance inquiries
    • Query Transactions
      • Transaction Search
    • Webhooks
      • Introduction
      • Good practices
      • Refunds
      • Card Payments
      • Check your webhooks
  • Kushki One
    • Cloud Services
      • Payment Cloud
        • Charge
        • Authorization (Pre-auth)
        • Capture
        • Re-authorization
        • Post-tip
        • Void
        • Refund
        • Abort
        • Transaction Search
      • Print Cloud
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment Local
        • Charge
        • Authorization (Pre-auth)
        • Capture
        • Re-authorization
        • Post-tip
        • Void
        • Refund
        • Transaction Search — Local
        • Transaction Search — Online
        • Abort
      • Print Local
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Raíz
  • Schemas
    • Shared
      • ErrorResponse
      • BadRequestResponse
      • InvalidBinResponse
      • payment_method
      • payment_submethod
      • messageFields
      • Channel
    • Amount & Taxes
      • Amount-cash-in
      • GetConfigurationRequest
    • Identity & Contact
      • Shipping Address
    • Card & Payments
      • ChargesVoidCardResponse
      • Promotions
      • Submerchant
    • Subscriptions
      • SubscriptionUpdate
      • SubscriptionAdjustmentRequest
      • SubscriptionTransactionsResponse
    • Webhooks
    • Analytics
      • AnalyticsTransactionItem
      • AnalyticsListResponse
    • Settlement
      • SettlementDateRangeRequest
      • SettlementTicketRequest
      • SettlementResponse
    • Chargebacks
      • ChargebackListResponse
      • ChargebackSearchRequest
    • Cash
      • CashChargeInitRequest
      • CashStatusResponse
    • Transfer
      • TransferTokenRequest
      • TransferInitRequest
      • TransferStatusResponse
    • Payouts
      • PayoutsWebhooksItem
    • Smart Link
      • SmartLinkAmount
    • Terminal
      • AmountWithTaxes
      • AmountCore
      • AmountWithTip
      • TerminalCardDetails
      • TerminalPosDetails
      • TerminalContactDetails
      • TerminalCardData
      • TransactionResponse
      • LinkFailure
      • TransactionSearchRequest
      • PrintJobRequest
      • PrinterError
      • PrintJobStatus
      • PrintWebhookPayload
    • RequestBodies
      • one-and-two-step-payment
    • currency
    • SettlementDateRangeRequest
    • SubscriptionTransactionsResponse
    • card-old
    • AmountWithTaxes-old
    • Card
    • Shipping Address
    • transactionType
    • ChargebackItem-old
    • SettlementTicketRequest
    • SubscriptionTransaction
    • amount
    • AmountCore-old
    • CommandText-old
    • networkToken
    • Language
    • extra_taxes
    • card_details
    • currency
    • ErrorResponse400-old
    • webhooksItem
    • ErrorResponse
    • SettlementResponse
    • extra_taxes-old
    • ExtraTaxes-old
    • CommandColumns-old
    • currency
    • card
    • orderDetails-old
    • Country
    • ContactDetails-old
    • ErrorResponse401-old
    • SettlementRecord
    • pos_details-old
    • ColumnItem-old
    • Amount
    • amount
    • documentType
    • extraTaxes-old
    • ErrorResponse403-old
    • card_details-old
    • TransactionResponse-old
    • CommandDivider-old
    • extraTaxes
    • enc_tlv
    • payment_method
    • ErrorResponse500-old
    • threeDomainSecure
    • enc_tlv
    • RawResponse-old
    • CommandFeed-old
    • Deferred
    • pos_details
    • deferred
    • binInfo
    • contact_details-old
    • CardData-old
    • CommandSpace-old
    • paymentMethod-old
    • Metadata
    • contact_details
    • Billing-Address-old
    • Deferred-old
    • deferred-old
    • sub_merchant
    • AmountWithTip-old
    • CommandCut-old
    • ContactDetails
    • sub_merchant
    • headers
    • Amount-old
    • metadata
    • LinkFailure-old
    • CommandImage-old
    • metadata
    • SubscriptionUpdate
    • TransactionSearchRequest-old
    • CommandQR-old
    • orderDetails
    • Subscription
    • payment_submethod
    • citMit
    • SubscriptionAdjustmentRequest
    • CommandBarcode-old
    • Shipping Address
    • messageFields
    • PrinterError-old
    • Billing Address
    • webhooksChargeback
    • Language
    • PrintJobStatus-old
    • currency-cash-in-old
    • product
    • webhooks
    • networkToken-old
    • PrintWebhookPayload-old
    • currency-CL-old
    • threeDomainSecure
    • webhooks
    • product-old
    • headers
    • webhooksChargeback
    • UnexpectedErrorResponse-old
    • citMit
    • network
    • Card-old-old
    • Submerchant-old
    • binInfo
    • Shipping-Address-old
    • messageFields
    • Promotions-old
    • UnexpectedErrorResponse
    • transactionType
    • InvalidBinResponse-old
    • GetConfigurationRequest-old
    • BadRequestResponse-old
    • Amount-CL-old
BienvenidaPerú 🇵🇪
México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
BienvenidaPerú 🇵🇪
México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. Analytics

Get transactions list v1

GET
/analytics/v1/transactions-list
Request a list of transactions for a specific merchant. The transactions are returned in sorted order, with the most recent transactions appearing first, and with pagination.

Deprecation Notice!#

This service will be deprecated starting July 2025.

We recommend using the Get Transactions List v2 endpoint instead, which offers more search filters and additional response fields for enhanced transaction management.
Please update your integration accordingly to ensure continued functionality and take advantage of the improved features.
To Keep in mind:
Transactions can only be queried through this endpoint 90 seconds after their creation.
The maximum number of transactions you can query per request is 600.
In case the limit parameter is not included in the request, the maximum number of transactions that will be returned is 100.

Request

Query Params

Header Params

Responses

🟢200
application/json
OK
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/analytics/v1/transactions-list?processor_name=undefined&sale_ticket_number=undefined&sync_mode=undefined&payment_method=undefined&response_text=undefined&response_code=undefined&subscription_id=undefined&merchant_name=undefined&transaction_status=undefined&ice_value=undefined&iva_value=undefined&subtotal_iva0=undefined&subtotal_iva=undefined&approval_code=undefined&approved_transaction_amount=undefined&request_amount=undefined&created=undefined&last_four_digits=undefined&card_type=undefined&merchant_id=undefined&processor_id=undefined&number_of_months=undefined&card_holder_name=undefined&transaction_type=undefined&currency_code=undefined&transaction_id=undefined&bin_card=undefined&ticket_number=undefined&offset=undefined&limit=undefined&to=undefined&from=undefined' \
--header 'Private-Merchant-Id;'
Response Response Example
{
    "total": 1,
    "data": [
        {
            "account_type": "",
            "acquirer_bank": null,
            "agenciaDeViaje_value": 0,
            "approval_code": "000000",
            "approved_transaction_amount": 57.36,
            "aurus_ticket_number": "880704136755757050",
            "bank_id": "",
            "bank_name": "",
            "bin_card": "545195",
            "buy_order": "",
            "card_holder_name": "John Doe",
            "card_type": "Credit",
            "client_name": "John Doe",
            "contact_person": "John",
            "channel": "PRESTASHOP",
            "commission_type": "",
            "contact_details": {
                "document_number": "1009283738",
                "document_type": "DNI",
                "email": "user@example.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone_number": "+593912345678"
            },
            "converted_amount": 0,
            "converted_currency": "PEN",
            "country": "Peru",
            "created": "2022-01-04T05:03:35.000Z",
            "credential_alias": null,
            "credential_id": null,
            "credential_metadata": null,
            "credit_type": null,
            "currency_code": "PEN",
            "description": "Payment description.",
            "document_number": "123456789",
            "document_type": "DNI",
            "email": "user@example.com",
            "foreign_card": true,
            "grace_months": "",
            "historical": [
                {
                    "approved_transaction_amount": 57.36,
                    "bin_card": "545195",
                    "card_holder_name": "John Doe",
                    "card_type": "Credit",
                    "contact_person": "John",
                    "country": "Peru",
                    "created": "2022-01-04T05:08:47.059Z",
                    "credential_alias": null,
                    "credential_id": null,
                    "credential_metadata": null,
                    "currency_code": "PEN",
                    "email": "user@example.com",
                    "foreign_card": true,
                    "ice_value": 0,
                    "iva_value": 0,
                    "last_four_digits": "5480",
                    "masked_credit_card": "545195XXXXXX5480",
                    "merchant_id": "20000000108481570000",
                    "merchant_name": "Tu comercio",
                    "nit": "12345678",
                    "payment_brand": "Mastercard",
                    "payment_method": "card",
                    "processor_id": "1000000858816509955116107200241",
                    "processor_merchant_id": "543210",
                    "processor_name": "MC Processor",
                    "processor_transaction_id": "463606",
                    "processor_type": "gateway",
                    "public_credential_id": null,
                    "request_amount": 57.36,
                    "response_code": "000",
                    "response_text": "Transacción aprobada",
                    "sale_approval_code": "000000",
                    "sale_ticket_number": "880704136755757050",
                    "sale_transaction_type": "SALE",
                    "subtotal_iva": 0,
                    "subtotal_iva0": 57.36,
                    "sync_mode": "online",
                    "terminal_id": null,
                    "ticket_number": "661641272926959146",
                    "transaction_id": "1641272926958551247",
                    "transaction_reference": "0e993c1d-03f7-48d5-93e4-63bb10cea776",
                    "transaction_status": "INITIALIZED",
                    "transaction_type": "VOID",
                    "unique_code": "1212334",
                    "visibility": "visible"
                }
            ],
            "iac_value": 0,
            "ice_value": 0,
            "identification": "123456789",
            "initialized": "2022-01-28T20:28:01.459Z",
            "issuing_bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "iva_value": 0,
            "last_four_digits": "5480",
            "masked_account_number": "",
            "merchant_id": "20000000108481570000",
            "merchant_name": "Tu comercio",
            "metadata": {
                "key0": "value0",
                "key1": "value1",
                "key2": "value2"
            },
            "method": "",
            "number_of_months": 4,
            "operation_id": "1643403824778083825",
            "origin": "",
            "owner_merchant_id": "",
            "parent_merchant_id": "",
            "parent_ticket_number": "",
            "payment_brand": "Mastercard",
            "payment_description": "-",
            "pin": "3403824670",
            "preauth_transaction_reference": "95dc21c8-8064-44a4-acb3-bde153c25460",
            "processor": {
                "code": "566",
                "message": "El token es invalido , o ya fue usado en otra transaccion."
            },
            "processor_bank_name": "",
            "processor_id": "1000000858816509955116107200241",
            "processor_name": "MC Processor",
            "processor_private_id": "",
            "processor_transaction_id": "463606",
            "processor_type": "gateway",
            "propina_value": 0,
            "provider": "",
            "public_credential_id": null,
            "recap": null,
            "retry": 0,
            "retry_count": 0,
            "request_amount": 57.36,
            "response_code": "000",
            "response_text": "Transaccion aprobada",
            "sale_approval_code": "000000",
            "sale_ticket_number": "880704136755757050",
            "sale_transaction_type": "SALE",
            "secure_id": "",
            "secure_service": "",
            "string_taxes": "{}",
            "subscription_id": "",
            "subscription_metadata": {
                "key1": "value1",
                "key2": "value2"
            },
            "subscription_trigger": "",
            "subtotal_iva": 0,
            "subtotal_iva0": 57.36,
            "sync_mode": "online",
            "tasaAeroportuaria_value": 0,
            "terminal_id": null,
            "ticket_number": "880704136755757050",
            "token": "dffddf9aa77549148d2450d0662c6e4b",
            "total_amount": 0,
            "transaction_id": "887693705036122450",
            "transaction_reference": "11a798d5-7565-4e78-a4e7-dfb7995f1c67",
            "transaction_status": "APPROVAL",
            "transaction_type": "SALE",
            "unique_code": "1212334",
            "user_type": "Jurídica",
            "visibility": "visible",
            "void_ticket_number": "661641272926959146",
            "card_country_code": "EC",
            "card_country": "Ecuador",
            "payment_method": "card",
            "masked_credit_card": "545195XXXXXX5480",
            "security": {
                "ip": "187.252.251.37",
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.110 Safari/537.36",
                "whitelist": false
            },
            "string_metadata": "{\"country\":\"Peru\",\"city\":\"Lima\",\"orderId\":\"20\",\"postalCode\":\"64700\",\"ip\":\"180.250.250.30\",\"billingAddressPhone\":null,\"totalAmount\":57.36,\"plugin\":\"prestashop\",\"province\":\"0\",\"name\":\"John\",\"currency\":\"PEN\",\"billingAddress\":\"centro #123\",\"email\":\"user@example.com\"}",
            "order_details": {
                "shipping_details": {
                    "name": "John Doe",
                    "phone": 593912345678,
                    "address1": "Av. Javier Prado Este 123",
                    "address2": "centro 123",
                    "city": "Lima",
                    "region": "Lima",
                    "country": "Peru",
                    "zipcode": 170402
                },
                "billing_details": {
                    "name": "John Doe",
                    "phone": 593912345678,
                    "address1": "Av. Javier Prado Este 123",
                    "address2": "centro 123",
                    "city": "Lima",
                    "region": "Lima",
                    "country": "Peru",
                    "zipcode": 170402
                },
                "site_domain": "kushki.com"
            },
            "product_details": {
                "product": [
                    {
                        "quantity": 3,
                        "price": 19.12,
                        "id": "1",
                        "title": "Hummingbird printed t-shirt",
                        "sku": "demo_1"
                    }
                ]
            }
        }
    ]
}
Modified at 2026-07-28 20:40:40
Previous
Analytics
Next
Get transactions list v2
Built with