Transaction Search — Local - Kushki Developer Portal

Queries transaction history stored locally on the terminal.
Does not require internet connectivity — useful for offline reconciliation
or when the acquirer backend is temporarily unreachable.
Results are sorted by date descending.

🚧 Beta — Early Access
This API is in early access. Endpoints, parameters, and response structures
may change without prior notice. Do not deploy to production without
coordinating with the Kushki integration team.

Local search does not support filtering by transaction_type, and only returns what that
specific terminal stored. Use Transaction Search — Online
when you need to filter by operation type or to see the merchant's full history.

Date filtering

start_date and end_date are Unix timestamps in milliseconds (13 digits).

A 10-digit value in seconds is a thousand times smaller than intended, so it lands in January
1970. The symptom depends on which field you got wrong:

What you sent	Resulting range	Symptom
Both fields in seconds	Entirely within January 1970	Empty result set
Only `start_date` in seconds	January 1970 → your end date	Returns the full history, not the range you meant
Only `end_date` in seconds	Your start date → January 1970	Validation error `2021`, `start_date must be before end_date`

The second case is the dangerous one: the request succeeds and returns data, just far more than
you asked for. Check the digit count before you reconcile.

Both fields are optional. Send 0 in both to disable date filtering and page through the full
history.

The value is an absolute instant on the Unix epoch, so it has no timezone of its own. To search a
local calendar day, convert that day's local boundaries in America/Bogota to epoch
milliseconds:

Local date and time	UTC offset	Value to send
2026-08-01 00:00:00	UTC-5	`1785560400000`
2026-08-31 23:59:59	UTC-5	`1788238799000`

Colombia does not observe daylight saving time, so America/Bogota stays on UTC-5 all year.
Resolve it with a timezone library anyway — hardcoding offsets is how these bugs start.

Required vs optional. Only page and size are required. The filters object and every
property inside it are optional.

What you encrypt

The body you send is the encrypted envelope. This is the plaintext object you encrypt — the field contract, not what travels on the wire:

{
    "page": 1,
    "size": 10,
    "filters": {
        "last_four_digits": "9130",
        "status": "APPROVAL",
        "start_date": 1785560400000,
        "end_date": 1788238799000
    }
}

See Authentication and request encryption for the derivation chain and the seven steps.

curl --location 'https://api-uat.kushkipagos.com/terminal/v1/sync/transaction_search_local' \ --header 'Authorization: Basic 9f2c4e1b7a63d8f05c2e9b41a7d3086fbe15c4d29a7e0b38f6c1d52a94e7b3c0' \ --header 'timestamp: 1748476800' \ --header 'encrypted_http_communication: true' \ --header 'Content-Type: application/json' \ --data '{ "data": "a3f14c7e9b02d85fbc1e46a9d370f28b:9e0d7f21c4a8b653e17d902fac48b5d6e83c1704a9f26db8" }'

{ "rawResponse": { "data": [ { "transactionReference": "094d2789-9033-4dc3-98f1-4c2ea3b6d7de", "clientTransactionId": "f475786a-a19d-425c-a973-96beb797c060", "ticketNumber": "113408571580923373", "type": "CHARGE", "eventStatus": "APPROVAL", "date": "1788894297411", "currency": "COP", "totalAmount": 100000, "kushkiAmount": { "iva": 0, "subtotalIva": 0, "subtotalIva0": 100000, "tip": 0, "currency": "COP", "extraTaxes": { "airportTax": 0, "iac": 0, "ice": 0, "travelAgency": 0 } }, "tax": 0, "tip": 0, "cashBack": 0, "discount": 0, "cardType": "credit", "franchise": "MASTERCARD", "cardData": { "pan": "**** **** **** 3743", "bin": "54914575", "cardHolderName": "", "bank": "MERCADO LENDING", "aid": "A0000000041010", "arqc": "729594E7904DA3D9", "tc": "", "entryMode": "NFC", "cvm": "none", "expirationMonth": "", "expirationYear": "", "serviceCode": "", "postalCode": "", "tagMap": {} }, "note": "", "captured": false, "voided": false, "refunded": false, "amountCaptured": 0, "amountVoided": 0, "amountRefunded": 0, "isPartial": false, "authExpirationDate": "", "authSearchReference": "", "originalAuthReference": "", "cancelledReAuth": false, "needReversal": false, "productList": null, "rawBody": { "transaction_reference": "094d2789-9033-4dc3-98f1-4c2ea3b6d7de", "transaction_status": "APPROVAL", "transaction_type": "charge", "authorized_amount": 100000, "ticket_number": "113408571580923373", "franchise": "MASTERCARD", "card_type": "credit", "cvm_type": "none", "F11": "108085", "kushki_response": { "code": "000", "message": "Approved or completed successfully." }, "message_fields": { "F38": "123456", "F39": "00" }, "additional_amounts": { "account_type": "", "amount": 0, "amount_type": "", "card_type": "", "currency_code": "" } } } ], "totalElements": 35, "totalPages": 4 } }

Transaction Search — Local

🚧 Beta — Early Access

Date filtering

What you encrypt

Request

Responses

Transaction Search — Local

🚧 Beta — Early Access#

Date filtering#

What you encrypt#

Request

Responses

🚧 Beta — Early Access

Date filtering

What you encrypt