> ## Documentation Index
> Fetch the complete documentation index at: https://developer.meow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Card Transactions

> Returns transactions for cards you have access to. Supports filtering by card, date range, status, merchant, and amount.



## OpenAPI

````yaml GET /cards/transactions
openapi: 3.1.0
info:
  title: Meow API
  description: >
    ## Overview


    The Meow API provides financial services and billing capabilities for your
    business.


    ### Core Features


    - **Financial data access**: access account information, transactions,
    balances, and payment networks.

    - **Crypto operations**: create and manage crypto contacts, and initiate
    USDC transfers across blockchain networks.


    ### Billing API


    The Billing API lets you create and manage invoices and collect payments:


    - **Product management**: create and manage products with custom pricing.

    - **Customer management**: maintain invoicing customers with their
    addresses.

    - **Invoice creation**: generate invoices with line items, discounts, and
    custom notes.

    - **Payment options**: accept payments via ACH, wire, international wire,
    card, and USDC.

    - **Collection accounts**: configure accounts for payment collection.


    ### Getting Started


    Authenticate by sending your API key in the `x-api-key` request header.


    To scope requests to a specific entity, include the `x-entity-id` header.
    Use the `/api-keys/accessible-entities` endpoint to list all entities
    accessible by your API key.


    ### Error Responses


    Errors return JSON with `code`, `message`, and `debug_message`. The `code`
    aligns with FDX where possible; use `debug_message` for troubleshooting
    only.


    Common error codes:


    - `500`: Internal server error

    - `501`: Subsystem unavailable

    - `503`: Scheduled maintenance

    - `601`: Data not found

    - `602`: Customer not authorized

    - `701`: Account not found

    - `703`: Invalid input (including invalid date ranges)

    - `704`: Account type not supported

    - `705`: Account is closed

    - `801`: Transaction not found
  contact:
    name: Meow
    url: https://meow.com/
    email: support@meow.com
  version: 1.0.0
  license:
    name: Proprietary
    url: https://www.meow.com/terms-of-service
servers:
  - url: https://api.meow.com/v1
    description: Meow API Production
  - url: https://api.sandbox.meow.com/v1
    description: Meow API Sandbox
security:
  - apiKeyAuth: []
tags:
  - name: API Keys
    description: Retrieve metadata about API keys and their accessible entities.
  - name: Accounts
    description: Access and manage accounts.
  - name: Approvals
  - name: Balances
    description: Retrieve account balances and available funds.
  - name: Bills
    description: View and manage bills for vendor payments.
  - name: Cards
    description: Manage virtual and physical cards, and view transactions and insights.
  - name: Collection Accounts
    description: Manage accounts for payment collection.
  - name: Contacts
    description: Manage contacts for crypto and USDC transfers.
  - name: Customers
    description: Manage invoicing customers and their details.
  - name: Entities
  - name: Invoices
    description: Create and manage invoices.
  - name: Limits
  - name: Line Items
    description: Manage invoice line items.
  - name: Partner Onboarding
    description: Onboard entities using your partner API key.
  - name: Partner Webhooks
  - name: Payment Methods
    description: View available payment method types.
  - name: Payment Networks
    description: Manage payment networks and routing information.
  - name: Products
    description: Manage products and pricing for invoicing.
  - name: Routing Numbers
    description: Validate routing numbers and retrieve bank information.
  - name: Security Policies
  - name: Simulations
    description: >-
      Trigger simulated events — inbound transfers, card authorizations,
      application approval — to test integrations end-to-end without real money
      movement. **Not available in production**: these endpoints exist only in
      sandbox and development environments and return `404 Not Found` in
      production.
  - name: Tax Forms
    description: Retrieve IRS tax forms (1099 family) issued for accounts.
  - name: Transactions
    description: Retrieve account transaction history and details.
  - name: Transfers
    description: >-
      Initiate ACH, wire, book, and crypto transfers, and retrieve transfer
      details.
  - name: Webhooks
    description: Manage webhook subscriptions and inspect delivery history.
paths:
  /cards/transactions:
    get:
      tags:
        - Cards
      summary: List Card Transactions
      description: >-
        Returns transactions for cards you have access to. Supports filtering by
        card, date range, status, merchant, and amount.
      operationId: list_card_transactions_cards_transactions_get
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            title: Limit
            default: 10
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            maximum: 1000000
            minimum: 0
            title: Offset
            default: 0
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 140
                minLength: 1
              - type: 'null'
            title: Query
        - name: merchant_name
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 140
                minLength: 1
              - type: 'null'
            title: Merchant Name
        - name: merchant_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                  format: uuid
              - type: 'null'
            title: Merchant Ids
        - name: cardholder_name
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 140
                minLength: 1
              - type: 'null'
            title: Cardholder Name
        - name: cardholder_emails
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                  format: email
                type: array
              - type: 'null'
            title: Cardholder Emails
        - name: card_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Card Id
        - name: card_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                  format: uuid
              - type: 'null'
            title: Card Ids
        - name: card_nickname
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 140
                minLength: 1
              - type: 'null'
            title: Card Nickname
        - name: card_is_physical
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            title: Card Is Physical
        - name: card_last_4
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 4
              - type: 'null'
            title: Card Last 4
        - name: from_original_created_time
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: From Original Created Time
        - name: to_original_created_time
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: To Original Created Time
        - name: statuses
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  $ref: '#/components/schemas/ExtAwxCardTransactionStatus'
              - type: 'null'
            title: Statuses
        - name: is_missing_requirements
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            title: Is Missing Requirements
        - name: sort_by
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/AwxTransactionSortEnum'
            default: ORIGINAL_CREATED_TIME
        - name: is_ascending
          in: query
          required: false
          schema:
            type: boolean
            default: false
            title: Is Ascending
        - name: network_transaction_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Network Transaction Id
        - name: amount_min
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1000000000
                minimum: 0
              - type: string
                pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
              - type: 'null'
            title: Amount Min
        - name: amount_max
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1000000000
                minimum: 0
              - type: string
                pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
              - type: 'null'
            title: Amount Max
        - $ref: '#/components/parameters/EntityIdHeader'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/MeowPaginatedList_AwxCardTransactionBusinessResponse_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - apiKeyAuth:
            - cards:read
components:
  schemas:
    ExtAwxCardTransactionStatus:
      type: string
      enum:
        - APPROVED
        - PENDING
        - FAILED
        - CLEARED
        - REVERSED
        - EXPIRED
      title: ExtAwxCardTransactionStatus
      x-enum-varnames:
        - APPROVED
        - PENDING
        - FAILED
        - CLEARED
        - REVERSED
        - EXPIRED
    AwxTransactionSortEnum:
      type: string
      enum:
        - AMOUNT
        - CARDHOLDER_NAME
        - IS_MISSING_REQUIREMENTS
        - MERCHANT_NAME
        - ORIGINAL_CREATED_TIME
      title: AwxTransactionSortEnum
      x-enum-varnames:
        - AMOUNT
        - CARDHOLDER_NAME
        - IS_MISSING_REQUIREMENTS
        - MERCHANT_NAME
        - ORIGINAL_CREATED_TIME
    MeowPaginatedList_AwxCardTransactionBusinessResponse_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/AwxCardTransactionBusinessResponse'
          type: array
          title: Items
        total:
          type: integer
          title: Total
        page:
          $ref: '#/components/schemas/MeowPage'
      type: object
      required:
        - items
        - total
        - page
      title: MeowPaginatedList[AwxCardTransactionBusinessResponse]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AwxCardTransactionBusinessResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        trace_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Trace Id
        status:
          $ref: '#/components/schemas/ExtAwxCardTransactionStatus'
        tx_type:
          $ref: '#/components/schemas/ExtAwxCardTransactionType'
        detail:
          type: string
          title: Detail
        amount:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount
        created_time:
          type: string
          format: date-time
          title: Created Time
        updated_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated Time
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
        attachments:
          items:
            $ref: '#/components/schemas/AwxCardTransactionAttachment'
          type: array
          title: Attachments
        merchant:
          anyOf:
            - $ref: '#/components/schemas/MerchantMetadataResponse'
            - type: 'null'
        is_missing_memo:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Missing Memo
        is_missing_receipt:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Missing Receipt
        original_created_time:
          type: string
          format: date-time
          title: Original Created Time
        cashback:
          anyOf:
            - $ref: '#/components/schemas/TransactionEarnedCashback'
            - type: 'null'
        card_id:
          type: string
          format: uuid
          title: Card Id
        cardholder_name:
          type: string
          title: Cardholder Name
        card_nickname:
          type: string
          title: Card Nickname
        is_physical:
          type: boolean
          title: Is Physical
        card_last_4:
          type: string
          title: Card Last 4
        network_transaction_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Network Transaction Id
        original_amount:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Original Amount
        original_currency:
          $ref: '#/components/schemas/Iso4217Code'
        industry:
          anyOf:
            - $ref: '#/components/schemas/DbIndustry'
            - type: 'null'
        category:
          anyOf:
            - $ref: '#/components/schemas/CardTransactionCategory'
            - type: 'null'
        failure_reason_user_friendly:
          anyOf:
            - type: string
            - type: 'null'
          title: Failure Reason User Friendly
        hold_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Hold Id
        credit_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Credit Id
        release_transaction_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Release Transaction Id
        hold_book_transfer_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Hold Book Transfer Id
      type: object
      required:
        - id
        - status
        - tx_type
        - detail
        - amount
        - created_time
        - attachments
        - merchant
        - is_missing_memo
        - is_missing_receipt
        - original_created_time
        - card_id
        - cardholder_name
        - card_nickname
        - is_physical
        - card_last_4
        - original_amount
        - original_currency
      title: AwxCardTransactionBusinessResponse
    MeowPage:
      properties:
        limit:
          type: integer
          maximum: 200
          minimum: 1
          title: Limit
          default: 10
        offset:
          type: integer
          maximum: 1000000
          minimum: 0
          title: Offset
          default: 0
      type: object
      title: MeowPage
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ExtAwxCardTransactionType:
      type: string
      enum:
        - AUTHORIZATION
        - CLEARING
        - REFUND
        - REVERSAL
        - ORIGINAL_CREDIT
      title: ExtAwxCardTransactionType
      x-enum-varnames:
        - AUTHORIZATION
        - CLEARING
        - REFUND
        - REVERSAL
        - ORIGINAL_CREDIT
    AwxCardTransactionAttachment:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        transaction_id:
          type: string
          format: uuid
          title: Transaction Id
        file_name:
          type: string
          title: File Name
        url:
          type: string
          title: Url
      type: object
      required:
        - id
        - transaction_id
        - file_name
        - url
      title: AwxCardTransactionAttachment
    MerchantMetadataResponse:
      properties:
        id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Id
        enriched_merchant_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Enriched Merchant Name
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
        labels:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Labels
        website:
          anyOf:
            - type: string
            - type: 'null'
          title: Website
        industry:
          anyOf:
            - $ref: '#/components/schemas/DbIndustry'
            - type: 'null'
      type: object
      title: MerchantMetadataResponse
    TransactionEarnedCashback:
      properties:
        dollars:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Dollars
        percentage:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,4}0*$
          title: Percentage
          description: Percentage represented as 4 digit decimal. 0.0001 = 0.01%
      type: object
      required:
        - dollars
        - percentage
      title: TransactionEarnedCashback
    Iso4217Code:
      type: string
      enum:
        - AED
        - AFN
        - ALL
        - AMD
        - ANG
        - AOA
        - ARS
        - AUD
        - AWG
        - AZN
        - BAM
        - BBD
        - BDT
        - BGN
        - BHD
        - BIF
        - BMD
        - BND
        - BOB
        - BOV
        - BRL
        - BSD
        - BTN
        - BWP
        - BYN
        - BZD
        - CAD
        - CDF
        - CHE
        - CHF
        - CHW
        - CLF
        - CLP
        - CNY
        - COP
        - COU
        - CRC
        - CUC
        - CUP
        - CVE
        - CZK
        - DJF
        - DKK
        - DOP
        - DZD
        - EGP
        - ERN
        - ETB
        - EUR
        - FJD
        - FKP
        - GBP
        - GEL
        - GHS
        - GIP
        - GMD
        - GNF
        - GTQ
        - GYD
        - HKD
        - HNL
        - HRK
        - HTG
        - HUF
        - IDR
        - ILS
        - INR
        - IQD
        - IRR
        - ISK
        - JMD
        - JOD
        - JPY
        - KES
        - KGS
        - KHR
        - KMF
        - KPW
        - KRW
        - KWD
        - KYD
        - KZT
        - LAK
        - LBP
        - LKR
        - LRD
        - LSL
        - LYD
        - MAD
        - MDL
        - MGA
        - MKD
        - MMK
        - MNT
        - MOP
        - MRU
        - MUR
        - MVR
        - MWK
        - MXN
        - MXV
        - MYR
        - MZN
        - NAD
        - NGN
        - NIO
        - NOK
        - NPR
        - NZD
        - OMR
        - PAB
        - PEN
        - PGK
        - PHP
        - PKR
        - PLN
        - PYG
        - QAR
        - RON
        - RSD
        - RUB
        - RWF
        - SAR
        - SBD
        - SCR
        - SDG
        - SLE
        - SEK
        - SGD
        - SHP
        - SLL
        - SOS
        - SRD
        - SSP
        - STN
        - SVC
        - SYP
        - SZL
        - THB
        - TJS
        - TMT
        - TND
        - TOP
        - TRY
        - TTD
        - TWD
        - TZS
        - UAH
        - UGX
        - USD
        - USN
        - UYI
        - UYU
        - UYW
        - UZS
        - VED
        - VES
        - VND
        - VUV
        - WST
        - XAF
        - XAG
        - XAU
        - XBA
        - XBB
        - XBC
        - XBD
        - XCD
        - XDR
        - XOF
        - XPD
        - XPF
        - XPT
        - XSU
        - XTS
        - XUA
        - XXX
        - YER
        - ZAR
        - ZMW
        - ZWG
        - ZWL
      title: Iso4217Code
    DbIndustry:
      properties:
        mcc:
          type: string
          pattern: '[0-9]{4}$'
          title: Mcc
        description:
          type: string
          title: Description
        irs_description:
          anyOf:
            - type: string
            - type: 'null'
          title: Irs Description
      type: object
      required:
        - mcc
        - description
        - irs_description
      title: DbIndustry
    CardTransactionCategory:
      type: string
      enum:
        - Advertising
        - Airlines
        - Books and Newspapers
        - Car Rental
        - Charity
        - Clothing
        - Electronics
        - Entertainment
        - Facilities Expenses
        - Financial Institutions and Fees
        - Fuel
        - Furniture
        - Government Services
        - Grocery
        - Ground Transportation
        - Insurance
        - Legal
        - Lodging
        - Meals
        - Medical
        - Office Supplies
        - Parking
        - Political
        - Professional Services
        - Recruiting
        - Rent
        - Restaurants
        - Shipping
        - Software
        - Taxes
        - Taxis and Rideshare
        - Technology Infrastructure
        - Training and Education
        - Utilities
        - Vehicle Expenses
      title: CardTransactionCategory
      x-enum-varnames:
        - advertising
        - airlines
        - books_and_newspapers
        - car_rental
        - charity
        - clothing
        - electronics
        - entertainment
        - facilities_expenses
        - financial_institutions_and_fees
        - fuel
        - furniture
        - government_services
        - grocery
        - ground_transportation
        - insurance
        - legal
        - lodging
        - meals
        - medical
        - office_supplies
        - parking
        - political
        - professional_services
        - recruiting
        - rent
        - restaurants
        - shipping
        - software
        - taxes
        - taxis_and_rideshare
        - technology_infrastructure
        - training_and_education
        - utilities
        - vehicle_expenses
  parameters:
    EntityIdHeader:
      name: x-entity-id
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: Optional `entity_id` to scope requests to a specific entity.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Meow API key, sent in the `x-api-key` header for authentication.
      x-scopes:
        - accounts:read
        - accounts:write
        - accounts:payment-networks
        - accounts:transactions
        - accounts:balances
        - accounts:statements
        - accounts:tax-documents
        - entity:create
        - transfers:crypto:write
        - transfers:usdc:write
        - transfers:ach:write
        - transfers:wire:write
        - transfers:book:write
        - contacts:read
        - contacts:write
        - billing:products:read
        - billing:products:write
        - billing:customers:read
        - billing:customers:write
        - billing:invoices:read
        - billing:invoices:write
        - billing:accounts:read
        - billpay:read
        - billpay:write
        - onboarding:read
        - onboarding:write
        - cards:read
        - cards:write
        - webhooks:read
        - webhooks:write
        - partner:onboarding:read
        - partner:onboarding:write
        - partner:webhooks:read
        - partner:webhooks:write
        - simulations:write
        - banking:limits:read
        - banking:limits:write

````