CARDS

Get Card Transactions

List a card's spend and authorization history.

GET /v1/cards/:tracking_id/transactions

Use this endpoint to

Reconcile everything a card has been used for
Show a customer their card's transaction history
Cross-check a disputed charge reported by a customer

Request

Path parameters

Parameter	Type	Required	Description
`tracking_id`	string	Yes	Card id from Issue Card

Query parameters

Parameter	Type	Required	Description
`page`	number	No	Page number
`limit`	number	No	Results per page, max 100

Code Samples

const params = new URLSearchParams({ page: "1", limit: "20" });

const response = await fetch(
  `https://sandbox.hitchpay.ng/v1/cards/EXTCARD123456/transactions?${params}`,
  { headers: { Authorization: "Bearer YOUR_ACCESS_TOKEN" } }
);

const data = await response.json();
console.log(data);

<?php

$query = http_build_query(["page" => 1, "limit" => 20]);

$ch = curl_init();
curl_setopt_array($ch, [
  CURLOPT_URL => "https://sandbox.hitchpay.ng/v1/cards/EXTCARD123456/transactions?" . $query,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ]
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

url = "https://sandbox.hitchpay.ng/v1/cards/EXTCARD123456/transactions"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
params = {"page": 1, "limit": 20}

response = requests.get(url, params=params, headers=headers)
print(response.json())

Response

{
  "status": "success",
  "message": "Transactions retrieved successfully.",
  "data": {
    "total_count": 8,
    "page": 1,
    "limit": 20,
    "transactions": [
      {
        "reference": "…",
        "amount": 12.50,
        "currency": "USD",
        "type": "PURCHASE",
        "mode": "DEBIT",
        "status": "SUCCESS",
        "description": "NETFLIX.COM",
        "merchant": "…",
        "created_at": "2026-07-14T10:15:00.000Z"
      }
    ]
  }
}

Fields

Field	Type	Description
`total_count`	number	Total transactions on this card
`page` / `limit`	number	Pagination echoed back
`reference`	string	Transaction reference
`amount`	number	Transaction amount
`currency`	string	`USD`
`type`	string	e.g. `PURCHASE`
`mode`	string	`DEBIT` or `CREDIT`
`status`	string	e.g. `SUCCESS`
`description`	string	Merchant descriptor as it appears on the transaction
`merchant`	string	Merchant identifier, when available
`created_at`	string	ISO 8601 timestamp

Errors

Code	Meaning
`UNAUTHORIZED`	Business not found or inactive
`NOT_FOUND`	Card not found

Questions? Email [email protected]. Also on GitBook.