List Transactions

Returns a paginated list of transactions on an account.

GET/v1/accounts/{id}/transactions

Query parameters

Field	Type	Description
`direction`	enum	credit \| debit
`type`	enum	card_purchase \| transfer_in \| transfer_out \| fee \| refund \| adjustment
`since`	ISO 8601	Only return transactions on/after this time.
`until`	ISO 8601	Only return transactions before this time.
`limit`	integer	Max 100. Default 25.
`cursor`	string	Pagination cursor.

curl "https://api.vaultspay.ae/v1/accounts/acc_01HX7.../transactions?limit=50" \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

Response

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "txn_01HX7...",
      "object": "transaction",
      "account_id": "acc_01HX7...",
      "type": "card_purchase",
      "direction": "debit",
      "amount": 4500,
      "currency": "AED",
      "status": "posted",
      "description": "Carrefour Dubai Mall",
      "merchant": {
        "name": "Carrefour",
        "mcc": "5411",
        "country": "AE"
      },
      "card_id": "card_01HX7...",
      "posted_at": "2026-04-23T09:18:44Z"
    }
  ],
  "has_more": true,
  "next_cursor": "txn_01HX76..."
}

Transaction states

pending — an authorisation has been placed, funds reserved.
posted — the transaction has cleared and affected the available balance.
reversed — the authorisation was released without settlement.
refunded — a full or partial refund was posted.

Get Balance IBAN Details