Transaction Search — Online
Testing
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/terminal/v1/sync/transaction_search_online
Requires internet connectivity. 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.
This is the only local-mode search that filters by transaction_type. It also sees
transactions made from other terminals of the same merchant, which the on-device search
cannot.
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/Lima 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 |
Peru does not observe daylight saving time, so America/Limastays 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
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/terminal/v1/sync/transaction_search_online' \
--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: PEN"
}Modified at 2026-08-31 16:19:24