Transaction Search
Testing
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/terminal/v1/{terminalSerial}/sync/transaction_search
🚧 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.
Cloud mode exposes a single unified search endpoint. For offline
local-terminal search, use the Local modetransaction_search_localendpoint.
Date filtering
start_date and end_date are Unix timestamps in milliseconds (13 digits).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.
0 in both to disable date filtering and page through the fullhistory.
local calendar day, convert that day's local boundaries in
America/Santiago to epochmilliseconds:
| Local date and time | UTC offset | Value to send |
|---|---|---|
| 2026-08-01 00:00:00 | UTC-4 (winter) | 1785556800000 |
| 2026-08-31 23:59:59 | UTC-4 (winter) | 1788235199000 |
Chile observes daylight saving time. The offset is UTC-4 in winter and UTC-3 in summer,
so never hardcode it — always let a timezone library resolveAmerica/Santiagofor the date you
are querying.
Required vs optional. Only pageandsizeare required. Thefiltersobject and every
property inside it are optional.
Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/terminal/v1/SN71652/sync/transaction_search' \
--header 'Authorization: nRvpFJZHjqLU4k8Rz2YiDvxA3mQs9oB1cW7eT0=' \
--header 'timestamp: 1700000000000' \
--header 'Content-Type: application/json' \
--data '{
"page": 1,
"size": 10,
"filters": {
"last_four_digits": "9130",
"transaction_type": "charge",
"start_date": 1785556800000,
"end_date": 1788235199000
}
}'Response Response Example
400 - Example 1
{
"type": "PARAMETER",
"code": "2001",
"param": "amount.subtotal_iva0",
"message": "Field amount.subtotal_iva0 is required."
}Modified at 2026-08-31 16:30:23