---
title: "List Card Events"
method: GET
path: "/card_event"
tags: ["Card Event"]
---

# List Card Events

`GET /card_event`

## Query parameters

- `card_id` string
- `trace_id` string
- `page_cursor` string
- `page_size` integer
- `from_date` string
- `to_date` string

## Response `200`

A dictionary with a `data` property that contains a list of up to `page_size` card_event elements, starting after the card_event described by `page_cursor`. If no more card_events are available, the resulting list will be empty.

- object
  - `data` object[]
    - `amount` string — Amount of money related to the event, with two decimal precision
    - `approved_amount` string — Approved amount of money related to the event, with two decimal precision
    - `atm` object — Object representing data related to ATM transactions
      - `network` string — ATM network for event
      - `network_fee` string — Fee associated with event
    - `bank_id` string — ID of the bank associated with the card event
    - `card_id` string — The ID of the card associated with the event. Filterable.
    - `currency` string — Three digit currency code
    - `decline_reason` string — The reason denied requests were not approved
    - `id` string — Unique identifier for object
    - `merchant` object — Object representing the merchant where the card event occurred
      - `address` object — Object containg `city`, `state`, `postal_code`, and `country` as strings
        - `city` string — Merchant city
        - `country` string — Three-digit country abbreviation
        - `postal_code` string — Five-digit postal code
        - `state` string — Two-digit state abbreviation
      - `mcc` string — Merchant category code
      - `mid` string — Merchant ID
      - `name` string — Name of the merchant
    - `message_type` string — Type of message. See Message Types
    - `network` string — Card network the event occurred on (e.g., `mastercard`)
    - `network_created_at` string — Timestamp of when the network states the event was created. This should match closely to the standard created_at field on the object. It may differ slightly due to the amount of time it takes Treasury Prime to process the event
    - `networkdata` object — Information received from the network. The structure of this information depends on the processor, but may contain information such as amount, fees, or additional information about the transaction
    - `org_id` string — ID of the organization associated with the card event
    - `processor` string — Processor that issued the card
    - `status` string — Status of event. One of `pending`, `error`, `approved`, `denied`, `timeout`, or `received`
    - `trace_id` string — Identifier used to link card events to transactions. Filterable.

---

[API](https://skmtc.net/treasuryprime/apis/account.md) · [All operations](https://skmtc.net/treasuryprime/apis/account/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryprime/account/revisions/95a3c69c14e8/schema)