The Query Transactions endpoint retrieves a paginated list of transactions processed on your POS terminals in Chile. Apply filters to narrow results by date range, BIN, card digits, or transaction reference.Returns a maximum of 10,000 transactions per query.
How it works#
POST /pos-analytics/v1/transactions/search — send pagination parameters and an optional filters object.{
"page": 1,
"size": 10,
"filters": {
"start_date": 1712286000000,
"end_date": 1712322035152,
"transaction_type": "charge"
}
}
Request fields#
| Field | Required | Description |
|---|
page | Yes | Page number. Starts at 1. |
size | Yes | Records per page. Maximum 500. |
filters | No | Optional filter object — see below. |
filters#
| Field | Type | Description |
|---|
start_date | integer | Start of the search window (Unix timestamp in ms). |
end_date | integer | End of the search window (Unix timestamp in ms). |
bin | string | First 6–8 digits of the card. |
last_four_digits | string | Last 4 digits of the card. |
client_transaction_id | string | Merchant-generated UUID for the transaction. |
transaction_reference | string | Kushki transaction reference. |
transaction_type | string | Type of transaction: capture, charge, checkIn, checkout, preAuth, reAuthorization, tip, or posTip. |
Response#
Returns an items array with one object per transaction.{
"items": [
{
"transaction_reference": "62c64ab2-1b09-48bd-ab98-4fa9b1893250",
"ticket_number": "111727462978861299",
"transaction_date": "2026-05-15T14:32:10.000Z",
"amount": {
"currency": "CLP",
"subtotal_iva": 0,
"subtotal_iva0": 10000,
"iva": 0,
"tip": 0,
"extra_taxes": {
"iac": 0
}
},
"card_mask": "438102XXXXXX4321",
"transaction_status": "APPROVAL",
"reference_number": "654321",
"authorization_code": "654321",
"transaction_type": "charge",
"transaction_mode": "Authorization",
"payment_brand": "VISA",
"merchant_id": "20000000109815430000",
"reading_type": "ICC"
}
]
}
Response item fields#
Transaction identification| Field | Description |
|---|
transaction_reference | Unique ID per transaction generated by Kushki. |
ticket_number | Unique ticket number assigned by Kushki. |
transaction_date | Date the transaction was created. |
reference_number | Reference number returned by the processor. |
trance_audit_number | Trace audit number (TRACE/TAN) from the processor. |
authorization_code | Issuer authorization code. |
| Field | Description |
|---|
transaction_status | APPROVAL or DECLINED. |
transaction_type | Type of the transaction — see the filters.transaction_type values above. |
transaction_mode | Authorization, Void, or Reverse. |
payment_brand | Card network (e.g., "VISA", "MASTERCARD"). |
reading_type | ICC, MCR, or NFC. |
| Field | Description |
|---|
card_mask | Masked number of the card used. |
amount | Amount breakdown: currency, subtotal_iva, subtotal_iva0, iva, tip, extra_taxes. |
deferred | Installment details, if the transaction was deferred: credit_type, grace_month, months. |
| Field | Description |
|---|
merchant_id | Merchant identifier. |
Authentication#
Environments#
https://api.kushkipagos.com/
Available Endpoints#
Query Transactions
Paginate through POS terminal transactions with optional filters by date, BIN, card digits, or transaction reference.
Got a suggestion on this documentation? Contact us.
