Card transactions

List card transactions

Returns a paginated list of card transactions for a company.

Required permissions:

  • payout:account:read
get/card_transactions

Query parameters

afterstring nullable

Returns the elements in the list that come after the specified cursor.

beforestring nullable

Returns the elements in the list that come before the specified cursor.

firstinteger nullable

Returns the first n elements from the list.

Example:42
lastinteger nullable

Returns the last n elements from the list.

Example:42
card_idstring nullable

Filter transactions to a specific card.

company_idstring required

The company to list card transactions for.

Example:biz_xxxxxxxxxxxxxx
created_afterstring date-time nullable

Only return transactions created after this timestamp.

Example:2023-12-01T05:00:00.401Z
created_beforestring date-time nullable

Only return transactions created before this timestamp.

Example:2023-12-01T05:00:00.401Z
direction'asc' | 'desc'

The direction of the sort.

status'pending' | 'completed' | 'reversed' | 'declined'

The lifecycle status of a card transaction.

Response

A successful response

Example response

{
  "data": [
    {
      "authorization_method": "ecommerce",
      "cashback_usd_amount": 6.9,
      "created_at": "2023-12-01T05:00:00.401Z",
      "currency": "USD",
      "declined_reason": "insufficient_funds",
      "local_amount": 6.9,
      "memo": "Team dinner",
      "merchant_category": "Software",
      "merchant_category_code": "5734",
      "merchant_icon_url": "https://logo.clearbit.com/example.com",
      "merchant_name": "Acme Corporation",
      "posted_at": "2023-12-01T05:00:00.401Z",
      "transaction_type": "spend",
      "usd_amount": 6.9
    }
  ]
}

Changes