---
title: "List Card Transactions"
method: GET
path: "/card_transactions"
tags: ["Cards"]
---

# List Card Transactions

`GET /card_transactions`

Lists an account's card transactions, newest first. Defaults to the account the credential belongs to. Covers every card the owner has ever had, including canceled cards and spend that predates a re-application, and team members only see transactions on the cards assigned to them. Pass `transaction_ids` to fetch specific transactions instead of paging for them.

## Query parameters

- `account_id` string
- `transaction_ids` string[]
- `card_id` string[]
- `cardholder_id` string[]
- `status` 'pending' | 'completed' | 'reversed' | 'declined'
- `created_after` string
- `created_before` string
- `order` 'created_at'
- `direction` 'asc' | 'desc'
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

no owner passed falls back to the credential's account

- object
  - `data` CardTransaction[], required
    - `card_id` string, required — The card this transaction was charged to, prefixed `icrd_`.
    - `cardholder_id` string, nullable, required — The user the card is assigned to, prefixed `user_`. Null when the card has no assigned cardholder.
    - `cashback_usd_amount` number, 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_at` string, required — When the transaction was authorized, as an ISO 8601 timestamp.
    - `currency` string, nullable, required — ISO 4217 currency code the merchant charged in.
    - `declined_reason` string, nullable, 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, nullable, required — Amount the merchant charged in their own currency. Pair with `currency`.
    - `merchant_category` string, nullable, required — Merchant category label, enriched where available and otherwise as the card network reported it.
    - `merchant_category_code` string, nullable, required — Four-digit ISO 18245 merchant category code (MCC).
    - `merchant_icon_url` string, nullable, required — URL of the enriched merchant logo. Null when no logo was matched.
    - `merchant_name` string, nullable, required — Merchant name, enriched where available and otherwise as the card network reported it.
    - `posted_at` string, 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_amount` number, nullable, required — Amount charged in USD. Negative when the merchant refunded the card.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)