Card Transactions

List the authorisations and settlements for a specific card.

GET/v1/cards/{id}/transactions

Query parameters

Field	Type	Description
`status`	enum	pending \| posted \| reversed \| declined \| refunded
`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/cards/card_01HX7.../transactions?status=posted" \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "txn_01HX7...",
      "card_id": "card_01HX7...",
      "status": "posted",
      "amount": 4500,
      "currency": "AED",
      "merchant": { "name": "Carrefour Dubai Mall", "mcc": "5411", "country": "AE" },
      "authorised_at": "2026-04-23T09:18:20Z",
      "posted_at": "2026-04-23T09:18:44Z"
    }
  ],
  "has_more": false
}

Declined transactions

Every declined authorisation includes a machine-readable decline_reason:

`decline_reason`	Meaning
`insufficient_funds`	Available balance less than auth amount.
`limit_exceeded_daily`	Daily spend ceiling hit.
`limit_exceeded_tx`	Per-transaction ceiling exceeded.
`control_atm_disabled`	ATM transactions disabled on the card.
`control_online_disabled`	Online transactions disabled on the card.
`control_mcc_blocked`	Merchant category code in blocklist.
`card_frozen`	Card is currently frozen.
`card_expired`	Card has expired.
`3ds_failed`	3D Secure challenge failed or timed out.

Set / Reset PIN Reveal Card Details