Sign in
latestOpenAPI 3.1.02026-08-163864115.7 MB

c363cb2feb95

Cards

Retrieve Card Transaction

Fetches a single card transaction by its citx_ identifier. The owner defaults to the account the credential belongs to.

get/card_transactions/{id}

Query parameters

account_idstring

The account that owns the transaction, prefixed biz_. Defaults to the credential's account.

Response

card transaction found

card_idstring required

The card this transaction was charged to, prefixed icrd_.

cardholder_idstring nullable required

The user the card is assigned to, prefixed user_. Null when the card has no assigned cardholder.

cashback_usd_amountnumber nullable required

Cashback earned on this transaction as a USD amount. Zero for declined or ineligible transactions, and null when cashback has not been computed yet.

created_atstring required

When the transaction was authorized, as an ISO 8601 timestamp.

currencystring nullable required

ISO 4217 currency code the merchant charged in.

declined_reasonstring nullable required

Why the transaction was declined. Null unless status is declined.

idstring required

Card transaction ID, prefixed citx_.

internationalboolean required

True when the merchant is outside the card's home country.

local_amountnumber nullable required

Amount the merchant charged in their own currency. Pair with currency.

merchant_categorystring nullable required

Merchant category label, enriched where available and otherwise as the card network reported it.

merchant_category_codestring nullable required

Four-digit ISO 18245 merchant category code (MCC).

merchant_icon_urlstring nullable required

URL of the enriched merchant logo. Null when no logo was matched.

merchant_namestring nullable required

Merchant name, enriched where available and otherwise as the card network reported it.

posted_atstring nullable required

When the card network settled the transaction, as an ISO 8601 timestamp. Null until it settles.

status'pending' | 'completed' | 'reversed' | 'declined' required

Current status of the transaction.

transaction_type'spend' required

The kind of card transaction. Always spend today.

usd_amountnumber nullable required

Amount charged in USD. Negative when the merchant refunded the card.

Example response

{
  "card_id": "icrd_xxxxxxxxxxxxxx",
  "cardholder_id": "user_xxxxxxxxxxxxxx",
  "cashback_usd_amount": 0.25,
  "created_at": "2026-01-01T12:00:00.000Z",
  "currency": "EUR",
  "declined_reason": "account_credit_limit_exceeded",
  "id": "citx_xxxxxxxxxxxxxx",
  "international": true,
  "local_amount": 22.5,
  "merchant_category": "Car Care Supplies",
  "merchant_category_code": "5533",
  "merchant_icon_url": "https://shinetime.example/icons/lone-star-detail-supply.png",
  "merchant_name": "Lone Star Detail Supply",
  "posted_at": "2026-01-01T12:00:00.000Z",
  "status": "completed",
  "transaction_type": "spend",
  "usd_amount": 24.99
}