kepa
Transaction Management/listTransactions

List Transactions

Search and filter transactions across the terminal.

GET/v1/transactions
Cursor-paginated transaction list, filterable by date range, status, type, card scheme, and POS reference ID. Ordered newest first. Use this for end-of-day reports, POS reconciliation screens, back-office dashboards, and dispute lookups. Supports up to 200 rows per page.
QUERY PARAMETERS
cursorstring

Opaque pagination cursor from a previous response.

limitinteger

Page size, 1–200. Defaults to 50.

Example: 50
fromstring · ISO 8601

Include transactions on or after this timestamp.

Example: "2026-04-01T00:00:00Z"
tostring · ISO 8601

Include transactions before this timestamp.

Example: "2026-04-09T00:00:00Z"
statusenum

Filter by transaction status.

APPROVEDDECLINEDCANCELLEDERRORREVERSEDPENDING_ONLINEPENDING_COMPLETION
typeenum

Filter by transaction type.

SALEPRE_AUTHPRE_AUTH_COMPLETEREFUNDVOIDCARD_READBALANCE_INQUIRY
cardSchemeenum

Filter by card scheme.

VISAMASTERCARDAMEXDISCOVERJCBUNIONPAYEFTPOSOTHER
referenceIdstring

Exact match on POS-assigned reference ID.

Example: "POS-INV-20260409-001"

Response

application/json

dataarrayrequired

Array of TransactionResponse objects, newest first.

hasMorebooleanrequired

Whether more pages exist.

Example: true
nextCursorstringnullable

Cursor for the next page. Null when hasMore is false.

totalCountinteger

Total matching transactions (may be approximate for large result sets).

Example: 142

commerce-api/openapi.yaml · listTransactions

GETLocal
http://terminal:8443/v1/transactions
Request
curl http://terminal:8443/v1/transactions?from=2026-04-01T00:00:00Z&status=APPROVED&limit=50 \
  -H "X-Api-Key: $ATLAS_API_KEY"
Response
{
  "data": [
    {
      "transactionId": "txn_01JQXYZ123456",
      "status": "APPROVED",
      "type": "SALE",
      "amount": 2500,
      "currency": "NZD",
      "cardScheme": "VISA",
      "maskedPan": "************1234",
      "entryMode": "CONTACTLESS",
      "referenceId": "POS-INV-20260409-001",
      "timestamp": "2026-04-09T09:14:22Z"
    },
    {
      "transactionId": "txn_01JQXYZ123457",
      "status": "DECLINED",
      "type": "SALE",
      "amount": 5000,
      "currency": "NZD",
      "cardScheme": "MASTERCARD",
      "maskedPan": "************5678",
      "entryMode": "CONTACTLESS",
      "responseCode": "51",
      "referenceId": "POS-INV-20260409-002",
      "timestamp": "2026-04-09T09:16:05Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cursor_txn_01JQXYZ123457",
  "totalCount": 142
}