Buvei
API ReferenceCards

List Card Transactions

Paginated transaction history for a single card.

GET/open-api/v1/cards/{cardId}/transactions

Returns the transaction history for a card. Supports date range and status filters, plus standard pagination.

Path parameters

cardIdstringpathrequired

Query parameters

fromDateintegerquery

Start date — epoch milliseconds.

toDateintegerquery

End date — epoch milliseconds.

statusstringquery

Filter by status — PENDING, COMPLETE, DECLINED, REVERSED, APPROVED, EXPIRED, REFUND.

pageintegerquerydefault: 1

Page number, 1-based.

sizeintegerquerydefault: 20

Page size.

Transaction status values

StatusMeaning
PENDINGAwaiting authorisation.
COMPLETESettled successfully.
DECLINEDIssuer or network declined.
REVERSEDSettled then reversed.
APPROVEDAuthorised but not yet captured.
EXPIREDAuthorisation expired without capture.
REFUNDMerchant-initiated refund.

Response

The response is paginated. records contains an array of transactions.

transactionIdstring
cardIdstring
cardNumberstring
Masked PAN.
descriptionstring
Merchant name or transaction description.
countrystring
ISO 3166-1 country.
reasonstring
Decline reason — null for approved transactions.
preAuthAmountinteger
Pre-authorisation amount in cents.
preAuthCurrencystring
preAuthTimeinteger
Epoch milliseconds.
settlementAmountinteger
Settlement amount in cents.
settlementCurrencystring
settlementTimeinteger
Epoch milliseconds.
statusstring
See table above.
feeinteger
Transaction fee in cents.
Response
{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "total": 150,
    "pages": 8,
    "current": 1,
    "size": 20,
    "records": [
      {
        "transactionId": "tc_abc123def",
        "cardId": "cid_1234567890",
        "cardNumber": "555543******1234",
        "description": "Amazon.com",
        "country": "US",
        "reason": null,
        "preAuthAmount": 5000,
        "preAuthCurrency": "USD",
        "preAuthTime": 1640995200000,
        "settlementAmount": 4850,
        "settlementCurrency": "USD",
        "settlementTime": 1640995300000,
        "status": "COMPLETE",
        "fee": 50
      }
    ]
  }
}

On this page

Path parameters
Query parameters
Transaction status values
Response