Artha API
  1. Transactions
  • Introduction
  • Authentication
  • KYC/KYB Requirements
  • API Setup Guide
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Update Customer
      PATCH
  • Cards
    • Submit KYC/KYB Applicant
      POST
    • Issue Card
      POST
    • Cards List
      GET
    • Get Card
      GET
    • Get Sensitive Card Details
      GET
  • Card Operations
    • Activate Card
      POST
    • Freeze Card
      POST
    • Unfreeze Card
      POST
    • Cancel Card
      POST
    • Replace Card
      POST
    • Set / Reset Card PIN
      POST
    • Get Card Limits
      GET
    • Update Card Limits
      POST
  • Funding
    • Top Up Card
      POST
    • Get Card Balance
      GET
    • List Top-Up History
      GET
  • Transactions
    • List All Transactions
      GET
    • List Card Transactions
      GET
    • List Customer Transactions
      GET
    • Get Transaction
      GET
  • Products
    • List Products
    • Get Product
  • Utilities
    • Upload Documents
  • Webhook's
    • Webhooks
  1. Transactions

List Card Transactions

GET
{{baseUrl}}/api/v1/cards/{cardId}/transactions
Returns paginated transactions for a specific card.

📤 Response Fields (per item)#

FieldTypeDescriptionNotes
transaction_idstring (uuid)--
card_idstring (uuid)--
customer_idstring (uuid)--
original_transaction_idstringFor refunds/reversals, the ID of the original transaction.nullable
local_currencystringCurrency used at the point of sale.nullable
local_amountnumberAmount in local (merchant) currency.-
authorized_amountnumberAmount authorized in card's billing currency.-
authorized_currencystring-nullable
authorization_codestring-nullable
authorized_atstring (date-time)--
feenumberTransaction fee charged.-
fee_currencystring-nullable
crossborder_feenumberForeign transaction / cross-border fee.-
crossborder_fee_currencystring-nullable
settle_amountnumber--
settle_currencystring-nullable
settle_datestring (date-time)-nullable
merchant_namestring- Example: Coffee Shop Ltdnullable
merchant_category_codestring- Example: 5812nullable
merchant_countrystring-nullable
merchant_citystring-nullable
typestringTransaction type: purchase, atm_withdrawal, refund, fee, top_up.nullable
sub_typestring-nullable
statusstringStatus: authorized, settled, declined, reversed.nullable
descriptionstring-nullable

Request

Path Params

Query Params

Header Params

Responses

🟢200
application/json
Card transactions retrieved.
Body

🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/transactions?limit&offset&status&type&from&to' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'
Response Response Example
200 - Example 1
{}
Modified at 2026-02-18 13:26:16
Previous
List All Transactions
Next
List Customer Transactions
Built with