Transaction Search
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
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/Bogota to epochmilliseconds:
| 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/Bogotastays on UTC-5 all year.
Resolve it with a timezone library anyway — hardcoding offsets is how these bugs start.
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 'https://api-uat.kushkipagos.com/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": 1785560400000,
"end_date": 1788238799000
}
}'Response Response Example
400 - parameter_error
{
"type": "PARAMETER",
"code": "2001",
"message": "Invalid currency. Expected: COP"
}Modified at 2026-08-31 15:20:45