---
title: "List card transactions"
method: GET
path: "/card_transactions"
tags: ["Card transactions"]
---

# List card transactions

`GET /card_transactions`

Returns a paginated list of card transactions for a company.

Required permissions:
 - `payout:account:read`

## Query parameters

- `after` string, nullable — Returns the elements in the list that come after the specified cursor.
- `before` string, nullable — Returns the elements in the list that come before the specified cursor.
- `first` integer, nullable — Returns the first _n_ elements from the list.
- `last` integer, nullable — Returns the last _n_ elements from the list.
- `card_id` string, nullable — Filter transactions to a specific card.
- `company_id` string, required — The company to list card transactions for.
- `created_after` string, date-time, nullable — Only return transactions created after this timestamp.
- `created_before` string, date-time, nullable — Only return transactions created before this timestamp.
- `direction` 'asc' | 'desc' — The direction of the sort.
- `status` 'pending' | 'completed' | 'reversed' | 'declined' — The lifecycle status of a card transaction.

## Response `200`

A successful response

- object — The connection type for PublicCardTransaction.
  - `data` CardTransactionListItem[], required — A list of nodes.
    - `authorization_method` string, nullable, required — How the card was presented or authenticated for the purchase.
    - `card_id` string, required — Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"VXNlci0xMA=="`) or integer (such as `4`) input value will be accepted as an ID.
    - `cashback_usd_amount` number, nullable, required — The cashback reward amount earned on this transaction, in USD.
    - `created_at` string, date-time, required — The datetime the card transaction was created.
    - `currency` string, nullable, required — The ISO 4217 currency code for the transaction amount.
    - `declined_reason` string, nullable, required — The issuer-provided reason the transaction was declined.
    - `id` string, required — The unique identifier for the card transaction.
    - `international` boolean, required — Whether the transaction was made with a merchant outside the card's home country.
    - `local_amount` number, nullable, required — The transaction amount in the merchant's local currency before conversion.
    - `memo` string, nullable, required — A user-provided note attached to the transaction.
    - `merchant_category` string, nullable, required — The enriched or raw category label for the merchant.
    - `merchant_category_code` string, nullable, required — The four-digit ISO 18245 merchant category code (MCC).
    - `merchant_icon_url` string, nullable, required — A URL to the enriched merchant logo image.
    - `merchant_name` string, nullable, required — The enriched or raw name of the merchant where the purchase was made.
    - `posted_at` string, date-time, nullable, required — When the transaction was settled by the card network.
    - `status` 'pending' | 'completed' | 'reversed' | 'declined', required — The lifecycle status of a card transaction.
    - `transaction_type` string, required — The type of transaction.
    - `usd_amount` number, nullable, required — The transaction amount in USD.
  - `page_info` PageInfo, required — Information about pagination in a connection.
    - `end_cursor` string, nullable, required — When paginating forwards, the cursor to continue.
    - `has_next_page` boolean, required — When paginating forwards, are there more items?
    - `has_previous_page` boolean, required — When paginating backwards, are there more items?
    - `start_cursor` string, nullable, required — When paginating backwards, the cursor to continue.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/60bbb4a6ffbc/schema)