GET/cards/{cardId}/transactions

List Card Transactions

Lists card transactions for a card. Returns core card transfer types only. Hard limit of 200 rows, newest first. No cursor pagination.

Query parameters must be PascalCase.

bash

curl -X GET "{{baseUrl}}/cards/{{cardId}}/transactions?DateFrom=2026-01-01&DateTo=2026-07-31&Status=Authorized&TransactionType=CardPurchaseTransfer" \
  -H "session-token: {{sessionToken}}" \
  -H "Accept: application/json"

Path variables

Field	Type	Required	Possible values	Description
`cardId`	string	Required	55d0c52f-79ee-4d38-acf4-a16c07957898	Card reference ID from list cards.

Query parameters

Field	Type	Required	Possible values	Description
`DateFrom`	string	Optional	2026-01-01	Start date (ISO 8601).
`DateTo`	string	Optional	2026-07-31	End date (ISO 8601). Must be >= DateFrom if both are set.
`Status`	string	Optional	Authorized \| AuthorizationDenied \| AuthorizationCanceled \| AuthorizationExpired \| PendingAuthorization \| Na	Authorization status (exact match). Valid: Authorized, AuthorizationDenied, AuthorizationCanceled, AuthorizationExpired, PendingAuthorization, Na.
`Merchant`	string	Optional	—	Merchant/description search (ILIKE).
`Amount`	number	Optional	—	Exact amount. Must be >= 0.
`AmountFrom`	number	Optional	—	Minimum amount. Must be >= 0.
`AmountTo`	number	Optional	—	Maximum amount. Must be >= 0 and >= AmountFrom if both are set.
`Country`	string	Optional	Italy \| IT \| ITA \| 380	Filter by merchant / acquiring country. Accepts country name, alpha-2, alpha-3, or ISO numeric (e.g. `Italy`, `IT`, `ITA`, `380`). Aliases such as `country`, `MerchantCountry`, and `merchantCountry` are accepted. Matches `Transaction_Country` and `Acquiring_Institution_Country_Code`. Must not return unrelated countries (e.g. filtering Italy must not return USA).
`Mcc`	string	Optional	6011 \| Eating Places	Filter by merchant category. Aliases: `MCC`, `mcc`, `MerchantCategoryCode`. If numeric (e.g. `6011`): exact match on merchant category code only (filtering `6011` must not return `5814`). If text: case-insensitive match on MCC description.
`TransactionType`	string	Optional	CardPurchaseTransfer \| CardAtmTransfer \| CashBackTransfer \| CardPurchaseReturn \| CardPurchaseCredit	Transfer type (exact match). PascalCase only (e.g. `CardPurchaseTransfer`).

Headers

Field	Type	Required	Possible values	Description
`session-token`	string	Required	—	SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header.

Additional info

Field	Type	Required	Possible values	Description
`Query — Status only`	object	Optional	—	`GET /cards/{cardId}/transactions?Status=Authorized`
`Query — date range`	object	Optional	—	`GET /cards/{cardId}/transactions?DateFrom=2026-01-01&DateTo=2026-07-31`
`Query — TransactionType`	object	Optional	—	`GET /cards/{cardId}/transactions?TransactionType=CardPurchaseTransfer`
`Query — amount range`	object	Optional	—	`GET /cards/{cardId}/transactions?AmountFrom=10&AmountTo=100`
`Query — combined filters`	object	Optional	—	`GET /cards/{cardId}/transactions?DateFrom=2026-01-01&DateTo=2026-07-31&Status=Authorized&TransactionType=CardPurchaseTransfer&AmountFrom=10&AmountTo=100`
`200 — Empty list`	object	Optional	—	No transactions matched the filters (or none exist).
`404 — Card not found`	object	Optional	—	cardId does not resolve to a card owned by this broker.
`Query — Mcc numeric exact`	object	Optional	—	`GET /cards/{cardId}/transactions?Mcc=6011` — exact MCC code match only.
`Query — Mcc description text`	object	Optional	—	`GET /cards/{cardId}/transactions?Mcc=Eating%20Places` — case-insensitive MCC description match.
`Query — Country`	object	Optional	—	`GET /cards/{cardId}/transactions?Country=IT` — also accepts Italy, ITA, or 380.

Example— Query — Status only

{
  "Status": "Authorized"
}

{
  "Status": "Authorized"
}

Example— Query — date range

{
  "DateFrom": "2026-01-01",
  "DateTo": "2026-07-31"
}

{
  "DateFrom": "2026-01-01",
  "DateTo": "2026-07-31"
}

Example— Query — TransactionType

{
  "TransactionType": "CardPurchaseTransfer"
}

{
  "TransactionType": "CardPurchaseTransfer"
}

Example— Query — amount range

{
  "AmountFrom": 10,
  "AmountTo": 100
}

{
  "AmountFrom": 10,
  "AmountTo": 100
}

Example— Query — combined filters

{
  "DateFrom": "2026-01-01",
  "DateTo": "2026-07-31",
  "Status": "Authorized",
  "TransactionType": "CardPurchaseTransfer",
  "AmountFrom": 10,
  "AmountTo": 100
}

{
  "DateFrom": "2026-01-01",
  "DateTo": "2026-07-31",
  "Status": "Authorized",
  "TransactionType": "CardPurchaseTransfer",
  "AmountFrom": 10,
  "AmountTo": 100
}

Example— 200 — Empty list

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": []
}

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": []
}

Example— 404 — Card not found

{
  "ResponseCode": 404,
  "ResponseMessage": "Card not found",
  "ResponseData": null
}

{
  "ResponseCode": 404,
  "ResponseMessage": "Card not found",
  "ResponseData": null
}

Example— Query — Mcc numeric exact

{
  "Mcc": "6011"
}

{
  "Mcc": "6011"
}

Example— Query — Mcc description text

{
  "Mcc": "Eating Places"
}

{
  "Mcc": "Eating Places"
}

Example— Query — Country

{
  "Country": "IT"
}

{
  "Country": "IT"
}

Path param stays camelCase (`cardId`). Query params and response enums are PascalCase. Valid Status: Authorized, AuthorizationDenied, AuthorizationCanceled, AuthorizationExpired, PendingAuthorization, Na. Valid TransactionType: CardPurchaseTransfer, CardAtmTransfer, CashBackTransfer, CardPurchaseReturn, CardPurchaseCredit. `Mcc` numeric = exact code; text = description ILIKE. `Country` accepts name / alpha-2 / alpha-3 / ISO numeric.

Response

Field	Type	Possible values	Description
`ResponseCode`	integer	200 \| 201 \| 204 \| 301 \| 400 \| 401 \| 403 \| 404 \| 410 \| 422 \| 500 \| 503	API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized).
`ResponseMessage`	string	Success \| Created \| NoContent \| BadRequest \| Unauthorized \| Forbidden \| NotFound \| Gone \| UnprocessableContent \| ServerError \| ResourceMoved \| ServiceUnAvailable \| UnProcessableEntity	Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome.
`ResponseData`	array	Please refer to below example for response body	Up to 200 card transactions, newest first.
`ResponseData[].Date`	string	—	Transaction date (YYYY-MM-DD).
`ResponseData[].Time`	string	—	Transaction time (HH12:MI:SS AM/PM).
`ResponseData[].MerchantName`	string	—	Merchant/description.
`ResponseData[].MerchantCity`	null	—	Always null currently.
`ResponseData[].MerchantCountry`	string \| null	—	Merchant country.
`ResponseData[].Mcc`	string \| null	—	Merchant category code.
`ResponseData[].TransactionType`	string	CardPurchaseTransfer \| CardAtmTransfer \| CashBackTransfer \| CardPurchaseReturn \| CardPurchaseCredit	Transfer type (PascalCase).
`ResponseData[].Amount`	number	—	Settlement or transfer amount.
`ResponseData[].Currency`	string	—	Currency code (default USD).
`ResponseData[].BillingAmount`	number	—	Billing amount.
`ResponseData[].BillingCurrency`	string	—	Billing currency. Always USD currently.
`ResponseData[].Status`	string	Authorized \| AuthorizationDenied \| AuthorizationCanceled \| AuthorizationExpired \| PendingAuthorization \| Na	Authorization status (PascalCase).
`ResponseData[].AuthorizationCode`	string \| null	—	Authorization code.
`ResponseData[].CardLastFourDigits`	string \| null	—	Last 4 digits of the card.

Example response

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": [
    {
      "Date": "2026-07-15",
      "Time": "02:45:10 PM",
      "MerchantName": "ACME STORE",
      "MerchantCity": null,
      "MerchantCountry": "US",
      "Mcc": "5411",
      "TransactionType": "CardPurchaseTransfer",
      "Amount": 42.5,
      "Currency": "USD",
      "BillingAmount": 42.5,
      "BillingCurrency": "USD",
      "Status": "Authorized",
      "AuthorizationCode": "123456",
      "CardLastFourDigits": "1234"
    }
  ]
}

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": [
    {
      "Date": "2026-07-15",
      "Time": "02:45:10 PM",
      "MerchantName": "ACME STORE",
      "MerchantCity": null,
      "MerchantCountry": "US",
      "Mcc": "5411",
      "TransactionType": "CardPurchaseTransfer",
      "Amount": 42.5,
      "Currency": "USD",
      "BillingAmount": 42.5,
      "BillingCurrency": "USD",
      "Status": "Authorized",
      "AuthorizationCode": "123456",
      "CardLastFourDigits": "1234"
    }
  ]
}

No cursor pagination — hard LIMIT 200.

Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.