Sign in
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
}

Changes

Changed in 2 of the 74 revisions of this API.4812

  • f1020c3ecda43See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 099fdc3be422489See the full diff
    • ▲

      the response's property format changed from date-time to no format for status

      response-property-type-changed

    • ▲

      the response's property format changed from date-time to no format for status

      response-property-type-changed

    • ▲

      removed the required property from the response with the status

      response-required-property-removed

    • ▲

      removed the required property from the response with the status

      response-required-property-removed

    • ●

      deleted the path request parameter id

      request-parameter-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      added the new spend enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      api tag Cards added

      api-tag-added

    • ○

      api tag Card transactions removed

      api-tag-removed

    • ○

      added the new optional header request parameter Api-Version-Date to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter account_id

      new-optional-request-parameter

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      added the required property to the response with the status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.