Transaction Search

POST

/pos-analytics/v1/transactions/search

List transactions made in a POS terminal. The transactions are returned in sorted order, with the most recent transactions appearing first.
Use the available filters to search for a specific transaction.

WARNING

This will return a maximum of 10,000 transactions.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

🟠400

🟠403

Request Example

Shell

JavaScript

Java

Swift

cURL

Query with filtersQuery without filters

curl --location --request POST 'https://api-uat.kushkipagos.com/pos-analytics/v1/transactions/search' \
--header 'Private-Credential-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "size": 10,
    "filters": {
        "bin": "541333",
        "last_four_digits": "0653",
        "start_date": 1712286000000,
        "end_date": 1712322035152,
        "client_transaction_id": "5bba557f-3df8-4f07-be20-ed1ad6b28c1d",
        "transaction_reference": "62c64ab2-1b09-48bd-ab98-4fa9b1893250",
        "transaction_type": "preAuth"
    }
}'

Response Example

200 - Query transactions

{
    "items": [
        {
            "acquirer_bank": "Kushki",
            "amount": {
                "iva": 0,
                "subtotal_iva": 0,
                "subtotal_iva0": 231,
                "tip": 0,
                "currency": "MXN",
                "extra_taxes": {}
            },
            "approval_code": "123456",
            "approved_transaction_amount": 231,
            "bin_card": "403338",
            "card_country": "ARG",
            "client_transaction_id": "61659d20-311c-4363-991d-7cdd73d36062",
            "country": "Mexico",
            "created": 1727462978861,
            "foreign_card": true,
            "issuing_bank": "CITIBANK",
            "last_four_digits": "6782",
            "masked_credit_card": "403338XXXXXX6782",
            "mcc": "4511",
            "merchant_id": "20000000107334554000",
            "merchant_name": "LENIPAY",
            "metadata": null,
            "payment_brand": "VISA",
            "payment_method": "card",
            "request_amount": 231,
            "ticket_number": "111727462978861299",
            "transaction_id": "111727462978861299",
            "transaction_reference": "5b0c2db4-5551-46d1-aa86-d274f12bfde3",
            "transaction_status": "APPROVAL",
            "transaction_type": "SALE"
        }
    ]
}

Modified at 2026-03-09 19:19:46

Request deferred options