Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-07-29"

Path Parameters

id
string
required

The card transaction ID, prefixed citx_.

Query Parameters

account_id
string

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

Response

card transaction found

card_id
string
required

The card this transaction was charged to, prefixed icrd_.

cardholder_id
string | null
required

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

cashback_usd_amount
number | null
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_at
string
required

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

currency
string | null
required

ISO 4217 currency code the merchant charged in.

declined_reason
string | null
required

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

id
string
required

Card transaction ID, prefixed citx_.

international
boolean
required

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

local_amount
number | null
required

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

merchant_category
string | null
required

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

merchant_category_code
string | null
required

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

merchant_icon_url
string | null
required

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

merchant_name
string | null
required

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

posted_at
string | null
required

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

status
enum<string>
required

Current status of the transaction.

Available options:
pending,
completed,
reversed,
declined
Example:

"pending"

transaction_type
enum<string>
required

The kind of card transaction. Always spend today.

Available options:
spend
Example:

"spend"

usd_amount
number | null
required

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