Transactions | Infracard API Docs

List transactions

Returns card transactions with filtering by type/status/time and pagination.

Authorization

x-api-key<token>

In: header

Query Parameters

cardIdstring

Filter by card ID.

typestring

Filter by transaction type.

Value in: "PURCHASE" | "REFUND" | "REVERSAL" | "VERIFICATION" | "FEE"

statusstring

Filter by transaction status.

Value in: "PENDING" | "COMPLETED" | "DECLINED" | "SETTLED"

startTimestring

Start of createdAt range (ISO-8601).

endTimestring

End of createdAt range (ISO-8601).

pagenumber

Page number (1-indexed).

Default: 1

limitnumber

Number of items per page.

Default: 20

Response Body

CardTransactionResponse paginated response

TypeScript Definitions

Use the response body type in TypeScript.

dataRequiredarray<object>

paginationRequiredobject

curl -X GET "https://example.com/transactions?cardId=card_01J2Y4K5M6N7P8Q9R0S1T2U3V4&type=PURCHASE&status=COMPLETED&startTime=2026-01-01T00%3A00%3A00.000Z&endTime=2026-01-31T23%3A59%3A59.999Z&page=1&limit=20" \
  -H "x-api-key: <token>"

fetch("https://example.com/transactions?cardId=card_01J2Y4K5M6N7P8Q9R0S1T2U3V4&type=PURCHASE&status=COMPLETED&startTime=2026-01-01T00%3A00%3A00.000Z&endTime=2026-01-31T23%3A59%3A59.999Z&page=1&limit=20", {
  headers: {
    "x-api-key": "<token>"
  }
})

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://example.com/transactions?cardId=card_01J2Y4K5M6N7P8Q9R0S1T2U3V4&type=PURCHASE&status=COMPLETED&startTime=2026-01-01T00%3A00%3A00.000Z&endTime=2026-01-31T23%3A59%3A59.999Z&page=1&limit=20"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("x-api-key", "<token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://example.com/transactions?cardId=card_01J2Y4K5M6N7P8Q9R0S1T2U3V4&type=PURCHASE&status=COMPLETED&startTime=2026-01-01T00%3A00%3A00.000Z&endTime=2026-01-31T23%3A59%3A59.999Z&page=1&limit=20"

response = requests.request("GET", url, headers = {
  "x-api-key": "<token>"
})

print(response.text)

{
  "data": [
    {
      "transactionId": "txn_01J2YAF1B2C3D4E5F6G7H8I9J0",
      "cardId": "card_01J2Y4K5M6N7P8Q9R0S1T2U3V4",
      "tradeNo": "trade_9876543210",
      "type": "PURCHASE",
      "status": "COMPLETED",
      "amount": "25.00",
      "currency": "USD",
      "merchantName": "Amazon",
      "fee": "0.50",
      "createdAt": "2026-02-09T18:04:05.000Z"
    }
  ],
  "pagination": {
    "total": 0,
    "page": 0,
    "limit": 0,
    "totalPages": 0
  }
}