Cards

List Card Transactions

Changed on

Lists the card transactions of an account or a user, newest first. 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.

get/card_transactions

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/card_transactions
  • Auth: HTTP bearer

Query parameters

account_idstring

The account whose card transactions to list, prefixed biz_. Provide this or user_id. Defaults to the credential's account.

user_idstring

The user whose personal card transactions to list, prefixed user_. Provide this or account_id. Only that user can read them.

transaction_idsstring[]

Return only these card transactions, each prefixed citx_. Repeat the parameter, or pass one comma-separated value.

[
  "citx_xxxxxxxxxxxxxx"
]
card_idstring[]

Return only transactions charged to these cards, each prefixed icrd_.

[
  "icrd_xxxxxxxxxxxxxx"
]
cardholder_idstring[]

Return only transactions on cards assigned to these users, each prefixed user_.

[
  "user_xxxxxxxxxxxxxx"
]
status'pending' | 'completed' | 'reversed' | 'declined'

Return only transactions with this status.

created_afterstring

Return only transactions authorized at or after this ISO 8601 timestamp.

created_beforestring

Return only transactions authorized at or before this ISO 8601 timestamp.

order'created_at'

The field to sort by. Defaults to created_at.

direction'asc' | 'desc'

The sort direction. Defaults to desc.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

no owner passed falls back to the credential's account

Example response

{
  "data": [
    {
      "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
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 7d2eaa643369Revision changes
    • info

      added the new optional query request parameter user_id

  • ff3a76573563Revision changes
    • breaking

      for the query request parameter first, default value 20 was added

    • warning

      for the query request parameter first, the max was set to 100.00

    • warning

      for the query request parameter last, the max was set to 100.00