---
title: "Get all transactions"
method: GET
path: "/transactions"
tags: ["Transactions"]
---

# Get all transactions

`GET /transactions`

## Query parameters

- `page` number, float — The page number to retrieve in a paginated response. Used in combination with **limit** to specify the starting point for a subset of records.
- `limit` number, float — A limit on the number of objects to be returned.
- `fromDate` string — The start date for filtering the records, formatted as **YYYY-MM-DD**. Only records from this date onwards will be retrieved.
- `toDate` string — The end date for filtering the records, formatted as **YYYY-MM-DD**. Only records up to this date will be retrieved.

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Response `200`

Return transactions

- object
  - `items` object[]
    - `id` string — Reap’s internal ID for the balance change record.
    - `card_id` string — The unique identifier of the card for which transaction details are being retrieved.
    - `bill_amount` number, float — The total amount charged to the cardholder, in the card’s currency. This amount includes the transaction amount plus any applicable fees.
    - `bill_currency` string — The [ISO 4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) for the bill. Defaults to the card’s currency if not specified.
    - `transaction_amount` number, float — The original amount of the transaction in the merchant’s currency, representing the base value of the purchase before fees are added.
    - `transaction_currency` string — The [ISO 4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) for the transaction. Defaults to the card’s currency if not specified.
    - `conversion_rate` string — The conversion rate applied from the transaction currency to the bill currency.
    - `merchant_data` object — Details about the merchant associated with the transaction.
      - `merchant_id` string — The unique identifier of the merchant.
      - `merchant_name` string — The merchant’s name.
      - `merchant_city` string — The city of the merchant’s registered address.
      - `merchant_post_code` string — The postal code of the merchant’s registered address.
      - `merchant_state` string — The state or province of the merchant’s registered address.
      - `merchant_country` string — The country of the merchant’s registered address.
      - `mcc_category` string — The merchant category code (MCC) category.
      - `mcc_code` string — The merchant category code.
    - `channel` 'ATM' | 'POS' | 'ECOMMERCE' | 'VISA_DIRECT' — Specifies the channel used for the transaction. Possible values: **ATM**: Automated Teller Machine. Transactions made via ATM, typically involving cash withdrawals. **POS**: Point of Sale. Transactions made at physical terminals, such as in-store card readers. **ECOMMERCE**: Online merchant transactions. These involve purchases made through e-commerce platforms or websites. **VISA_DIRECT**: Transactions processed using Visa Direct.
    - `pos_entry_mode` object — - **0**: Terminal not used - **1**: Key entry - **2**: Magnetic strip read (general or track 2) - **3**: Bar code read (Visa only) - **4**: OCR read - **5**: Chip card read-data reliable - **6**: Track 1 read - **7**: Proximity payment originating using VSDC chip data rules - **90**: Entire content of magnetic stripe was transmitted in authorization request (CVV) - **91**: Proximity payment originating using magnetic strip data rules - **95**: Initiated by chip card: CVV data may be unreliable
      - `code` string — The unique identifier of the POS.
      - `description` string — A description of the POS.
    - `fees` object — Details of fees involved in the transaction, in the **bill_currency**
      - `atm_fees` string — ATM fees incurred.
      - `fx_fees` string — Foreign exchange fees incurred.
    - `mcc_padding_amount` number, float — The amount padded for this transaction. Learn more about [MCC padding](https://reap.readme.io/docs/risk-management-mcc-padding).
    - `wallet` string — Indicates if the transaction was processed through a digital wallet. Possible values: **ANDROID**: Transaction processed via Google Pay. **APPLE**: Transaction processed via Apple Pay.
    - `cleared_at` string — The date the transaction was cleared, if applicable.
    - `created_at` string — The date the transaction was created.
    - `status` string — Status of this transaction event. Possible values: **PENDING** **VOID** **DECLINED** **CLEARED**
    - `category` string — Card category. Default value **Others**.
    - `is_credit` boolean — Indicates whether the transaction is a reversal or refund. If the transaction is a reversal or refund, this field will return **true**.
    - `decline_reason` object — Details about a declined transaction. This field is populated only if the transaction status is **DECLINED**.
      - `response_code` string — The decline response code. Read more about [transaction decline](https://reap.readme.io/docs/transaction-decline).
      - `description` string — A description of the decline reason. Refer to this page for more information about decline reasons
    - `lifecycle_events` object[] — Details about how the transaction affects the lifecycle of the card balance.
      - `affect_balance` boolean, required — The card balance after this transaction.
      - `bill_amount` string, required — The billed amount.
      - `bill_currency` string, required — The billing currency. Defaults to the card program’s currency.
      - `created_at` string, required — The date the transaction was created.
      - `lifecycle_event_id` string, required — The unique identifier for this lifecycle event.
      - `mcc_padding_amount` string — The amount padded during the lifecycle event.
      - `transaction_amount` string, required — The transaction amount.
      - `transaction_currency` string, required — The transaction currency.
      - `type` 'authorization' | 'authorization.clearing' | 'authorization.reversal' | 'authorization.advice' | 'refund', required — The type of the transaction event. Possible values: **authorization** **authorization.clearing** **authorization.reversal** **authorization.advice** **refund** Learn more about all [transaction event types](https://reap.readme.io/reference/webhook-eventtype-transaction#/).
      - `pos_data` object
        - `pos_transaction_data` object, required
          - `cardholder_present_indicator` 'cardholder_not_present_unspecified' | 'cardholder_not_present_mail_order' | 'cardholder_not_present_telephone_order' | 'cardholder_not_present_standing_auth/recurring_transaction' | 'cardholder_not_present_ecommerce' | 'cardholder_not_present_installment_transaction' | 'unknown', required
          - `card_present_indicator` 'card_not_present' | 'card_present', required
          - `card_data_input_method` 'information_not_provided' | 'manual_no_terminal' | 'magnetic_stripe_read' | 'bar_code' | 'optical_character_recognition' | 'chip_dip/emv_contact' | 'key_entered_or_added_manually' | 'emv_contactless_or_vsdc_contactless' | 'ecommerce' | 'ecommerce_with_emv_cryptogram' | 'contactless_magnetic_stripe' | 'account_data_on_file' | 'key_entered_by_acquirer' | 'micr_reader' | 'qr_code' | 'unknown', required
          - `cardholder_authentication_method` string[], required
          - `cardholder_authentication_entity` string[], required
          - `pos_fraud_indicator` 'no_problem' | 'merchant_suspicious' | 'merchant_verified_the_cardholder_id' | 'unknown', required
          - `3d_secure_authentication_method` 'unknown/not_applicable' | '3ds_1.0.2_or_prior_or_3ds_1.0.2_frictionless_flow' | 'challenge_flow_using_otp_via_sms_method' | '3ds_2.0_challenge_flow_using_otp_via_any_other_method' | '3ds_2.0_challenge_flow_using_out_of_band_with_biometric_method' | '3ds_2.0_frictionless_flow', required
          - `security_protocol_between_cardholder_device_and_merchant` 'none' | 'channel_encryption' | 'not_applicable' | 'unknown', required
          - `card_device_type` 'card' | 'mini-card' | 'jewelry' | 'mobile_phone' | 'non-card' | 'unknown', required
          - `merchant_or_cardholder_initiated_indicator` 'cardholder_initiated' | 'merchant_initiated' | 'unknown', required
          - `merchant_initiated_transaction_type_indicator` 'credential_on_file' | 'standing_order' | 'subscription' | 'instalment' | 'partial_shipment' | 'related/delayed_charge' | 'no_show_charge' | 'resubmission' | 'unknown/not_applicable', required
        - `pos_terminal_capability` object, required
          - `partial_approval_support` 'not_supported' | 'supported' | 'unknown', required
          - `card_data_input_capability` string[], required
          - `cardholder_authentication_capability` string[], required
          - `card_capture_capability` 'card_capture_not_supported' | 'card_capture_supported' | 'unknown', required
          - `terminal_attended_indicator` 'no_terminal_used' | 'attended' | 'unattended' | 'unknown', required
          - `terminal_environment` 'no_terminal_used' | 'on_premises_of_card_acceptor' | 'off_premises_of_card_acceptor' | 'on_premises_of_cardholder' | 'unknown', required
          - `terminal_card_data_output_capability` 'unknown' | 'none' | 'magnetic_stripe_write' | 'icc' | 'other', required
          - `terminal_output_capability` 'unknown' | 'none' | 'print_only' | 'display_only' | 'print_and_display', required
          - `terminal_pin_capture_capability` 'none' | 'unknown' | 'yes_max_length_4_digits' | 'yes_max_length_5_digits' | 'yes_max_length_6_digits' | 'yes_max_length_7_digits' | 'yes_max_length_8_digits' | 'yes_max_length_9_digits' | 'yes_max_length_10_digits' | 'yes_max_length_11_digits' | 'yes_max_length_12_digits', required
          - `terminal_type` 'unknown/unspecified' | 'cat_level_1_automated_dispensing_machine' | 'cat_level_2_self_service_terminal' | 'cat_level_3_limited_amount_terminal' | 'cat_level_4_in_flight_commerce_terminal' | 'cat_level_5' | 'cat_level_6_e_commerce_terminal' | 'cat_level_7_transponder' | 'mobile_pos_acceptance_device' | 'manual' | 'atm' | 'electronic_cash_register_or_normal_attended_pos_device' | 'unknown', required
  - `meta` object — Pagination metadata for the response.
    - `itemCount` number, float, required — The number of items returned on the current page.
    - `totalItems` number, float, required — The total number of items across all pages.
    - `itemsPerPage` number, float, required — The maximum number of items that can be returned per page.
    - `totalPages` number, float, required — The total number of pages available based on the **itemsPerPage** and **totalItems**.
    - `currentPage` number, float, required — The current page number in the paginated response.

---

[API](https://skmtc.net/reap-global/apis/reap-api.md) · [All operations](https://skmtc.net/reap-global/apis/reap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reap-global/reap-api/revisions/525072733e02/schema)