Get Card Transactions

Fetches all transactions of the specified cards according to the query parameters.

Retrieves the transaction history (credits, debits, charges) associated with a specific virtual card. Each transaction record includes type, amount, currency, description, and date. Useful for displaying detailed activity logs or generating monthly statements.

Before you begin!

You can filter or paginate this data on the frontend if needed. Ideal for auditing or user self-service.

POST {{ BASE }}/get-card-history/{cardid}

--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'

Below are the request body parameters 🎉

Request Body

Name	Type	Description
cardid	String	The unique ID of the virtual card (from Padiwise)

Response Body

{
    "status": true,
    "message": "All card transactions retrieved successfully",
    "data": [
        {
            "paymentReference": "PadiwiseHUSVC-c4c1553aebbe5",
            "externalReference": "CW-67fcd713871ca",
            "type": "Debit",
            "amount": 3,
            "provider": "PadiwiseHUSVC",
            "narration": "Padiwise Visa Card Withdrawal|PadiwiseHUSVC-c4c1553aebbe5",
            "runningBalance": -3,
            "createdAt": "2025-04-16T09:17:14.407Z"
        },
        {
            "paymentReference": "41b6a7af-bb5c-4209-bce9-88e4d4c0b0c1",
            "externalReference": null,
            "type": "Debit",
            "amount": 0.3,
            "provider": "PadiwiseHUSVC",
            "narration": "41b6a7af-bb5c-4209-bce9-88e4d4c0b0c1|GOOGLE *TEMPORARY HOLD g.co/helppay US",
            "runningBalance": 0,
            "createdAt": "2025-04-11T18:15:14.618Z"
        },
        
        ..........
}