# Fetch transactions by filters

When you request a list of transactions, the response is limited to the maximum number of records you specified in the query. If there are more transactions available beyond that limit, you don’t need to start over. Instead, you can continue fetching results from where you left off by including the prev_id parameter in your next request.

Endpoint: GET /transaction
Version: 1.2
Security: X-Api-Key

## Query parameters:

  - `created_at_from` (string)
    Filter transactions created after this date (inclusive). Format: ISO 8601.
    Example: "2024-02-15T13:38:47.173Z"

  - `created_at_to` (string)
    Filter transactions created before this date (inclusive). Format: ISO 8601.
    Example: "2024-02-15T13:38:47.173Z"

  - `limit` (integer)
    Maximum number of transactions to return (default is 100, maximum is 1000, minimum is 1).
    Example: "100"

  - `prev_id` (string)
    Fetch transactions with IDs less than this value for pagination.
    Example: "2JWZGUKDK2DK2"

  - `response_code` (integer)
    Filter transactions by response code for more specific results.
    Example: "1000, 2000"

  - `transaction_type` (string)
    Filter transactions by type. Multiple types can be specified, separated by commas. Supported types include TOKEN, THREE_DS, SALE, AUTHORIZE, PAYOUT, CHARGEBACK, CHARGEBACK_REVERSAL, RDR, RDR_REVERSAL, REFUND, VOID and FRAUD_ALERT.
    Example: "SALE,THREE_DS,REFUND"

## Response 200 fields (application/json):

  - `type` (string, required)
    Enum: "TRANSACTION"

  - `data` (array, required)

  - `data.transaction_id` (string, required)

  - `data.transaction_type` (string, required)
    Enum: "TOKEN", "THREE_DS", "SALE", "AUTHORIZE", "PAYOUT", "CHARGEBACK", "CHARGEBACK_REVERSAL", "RDR", "RDR_REVERSAL", "REFUND", "VOID", "FRAUD_ALERT"

  - `data.transaction_status` (string, required)
    Enum: "SUCCESS", "DECLINE", "ERROR"

  - `data.created_at` (string, required)
    UTC date time format

  - `data.response_code` (number, required)
    Code from [response codes](#section/Constants/Response-Codes)

  - `data.response_text` (string, required)
    Message from [response codes](#section/Constants/Response-Codes)

  - `data.transaction_details` (object, required)

  - `data.transaction_details.three_ds_authentication_value` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_processor` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_server_transaction_id` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_eci` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_status` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_challenge_type` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_version` (string)
    Only for 3ds postback

  - `data.transaction_details.three_ds_reason_code` (string)

  - `data.transaction_details.three_ds_reason_text` (string)

  - `data.transaction_details.three_ds_rule_id` (string)

  - `data.transaction_details.processor_merchant_account_id` (string)

  - `data.transaction_details.processor_transaction_id` (string)

  - `data.transaction_details.processor` (string, required)

  - `data.transaction_details.processor_response_code` (string, required)

  - `data.transaction_details.processor_response_text` (string)
    Response text from processor

  - `data.transaction_details.processor_response_amount` (string)

  - `data.transaction_details.processor_response_currency_code` (string)

  - `data.transaction_details.processor_reference_id` (string)

  - `data.transaction_details.processor_used_low_value` (boolean)

  - `data.transaction_details.processor_used_cit` (boolean)

  - `data.transaction_details.processor_used_mit` (boolean)

  - `data.transaction_details.processor_requested` (boolean)

  - `data.transaction_details.fraud_alert_processor` (string)

  - `data.transaction_details.reason` (string)

  - `data.transaction_details.initiated_by` (string)

  - `data.transaction_details.routing_rule_id` (string)

  - `data.transaction_details.sticky_processor_used` (boolean)

  - `data.transaction_details.transaction_hash` (string)

  - `data.transaction_details.payment_form_has_been_displayed` (boolean)

  - `data.transaction_details.cascade_attempt` (string)
    Sequential number of the cascading attempt to payment processors

  - `data.transaction_details.has_been_cascaded` (boolean)
    Indicates whether cascading was performed

  - `data.transaction_details.arn` (string)

  - `data.transaction_details.reference_transaction_id` (string)

  - `data.payment_context` (object)

  - `data.payment_context.browser_user_agent` (string)

  - `data.payment_context.browser_screen_height` (string)

  - `data.payment_context.browser_color_depth` (string)

  - `data.payment_context.browser_language` (string)

  - `data.payment_context.browser_timezone_offset` (string)

  - `data.payment_context.browser_screen_width` (string)

  - `data.payment_context.challenge_window_size` (string)

  - `data.payment_context.browser_has_js_enabled` (string)

  - `data.payment_context.browser_has_java_enabled` (string)

  - `data.payment_context.browser_accept_header` (string)

  - `data.payment_context.ip` (string)

  - `data.payment_details` (object, required)

  - `data.payment_details.payment_token_id` (string)
    Only for CARD flow

  - `data.payment_details.payment_token_type` (string)

  - `data.payment_details.card_scheme` (string)
    Only for CARD flow

  - `data.payment_details.card_bin` (string)
    Only for CARD flow

  - `data.payment_details.card_bin_country_name` (string)
    Only for CARD flow

  - `data.payment_details.card_bin_country_code` (string)
    Only for CARD flow

  - `data.payment_details.card_bin_type` (string)
    Only for CARD flow

  - `data.payment_details.card_bin_bank` (string)

  - `data.payment_details.card_bin_category` (string)

  - `data.payment_details.card_scheme_type` (string)

  - `data.payment_details.card_last_four_digits` (string)
    Only for CARD flow

  - `data.payment_details.customer_full_name` (string)
    Only for CARD flow

  - `data.payment_details.customer_phone_number` (string)

  - `data.payment_details.customer_email` (string)

  - `data.payment_details.customer_first_name` (string)

  - `data.payment_details.customer_last_name` (string)

  - `data.payment_details.card_expiry_month` (string)
    Only for CARD flow

  - `data.payment_details.card_expiry_year` (string)
    Only for CARD flow

  - `data.payment_details.card_data_id` (string)
    Only for CARD flow

  - `data.payment_details.customer_selected_country_code` (string)

  - `data.payment_details.crypto_network` (string)

  - `data.payment_details.crypto_address` (string)

  - `data.payment_details.crypto_withdrawal_address` (string)

  - `data.payment_details.debtor_iban` (string)

  - `data.payment_details.debtor_bic` (string)

  - `data.payment_details.cit_enabled` (string)

  - `data.payment_details.creditor_name` (string)

  - `data.payment_details.creditor_bank_account` (string)

  - `data.payment_details.creditor_bank_name` (string)

  - `data.payment_details.creditor_bank_bic` (string)

  - `data.payment_details.payment_email` (string)

  - `data.payment_details.beneficiary_email` (string)

  - `data.payment_details.reference` (string)

  - `data.payment_details.creditor_country` (string)

  - `data.payment_details.creditor_email` (string)

  - `data.payment_details.creditor_phone` (string)

  - `data.payment_details.creditor_bank_code` (string)

  - `data.payment_details.creditor_bank_number` (string)

  - `data.payment_details.first_buy_for_merchant_customer` (boolean)

  - `data.payment_details.first_buy_for_payment_token` (boolean)

  - `data.payment_details.first_buy_for_merchant_customer_and_payment_token` (boolean)

  - `data.payment` (object, required)

  - `data.payment.transaction_amount` (string)

  - `data.payment.transaction_currency_code` (string)
    Currency code (ISO 4217)

  - `data.payment.payment_id` (string, required)

  - `data.payment.initial_subscription_id` (string)

  - `data.payment.payment_type` (string, required)
    Enum: "SALE", "AUTHORIZE", "MIT_SALE", "MIT_AUTHORIZE", "RECURRING"

  - `data.payment.payment_method` (string, required)

  - `data.payment.merchant_id` (string, required)

  - `data.payment.merchant_payment_id` (string)

  - `data.payment.merchant_customer_id` (string, required)

  - `data.payment.email` (string, required)

  - `data.payment.amount` (string, required)

  - `data.payment.language` (string)

  - `data.payment.country_code` (string, required)
    Country Code (ISO 3166-2)

  - `data.payment.currency_code` (string, required)
    Currency code (ISO 4217)

  - `data.payment.base_amount` (string)

  - `data.payment.base_currency_code` (string)
    Currency code (ISO 4217)

  - `data.payment.transaction_fee_amount` (string)

  - `data.payment.transaction_fee_currency_code` (string)
    Currency code (ISO 4217)

  - `data.payment.transaction_tax_amount` (string)

  - `data.payment.transaction_tax_currency_code` (string)
    Currency code (ISO 4217)

  - `data.payment.transaction_tax_percentage` (string)

  - `data.payment.transaction_tax_type` (string)
    Enum: "INCLUDED", "ON_TOP"

  - `data.payment.transaction_tax_label` (string)
    Enum: "TAX", "VAT", "GST", "SALES_TAX"

  - `data.payment.forced_3d` (boolean)
    If needs to initiate 3d secure from merchant side

  - `data.payment.success_url` (string)
    required only for SALE | AUTHORIZE | RECURRING

  - `data.payment.failure_url` (string)
    required only for SALE | AUTHORIZE | RECURRING

  - `data.payment.payment_token_id` (string)
    Token from original payment. Used for MIT_SALE | MIT_AUTHORIZE

  - `data.payment.shop_name` (string)
    Shop name

  - `data.payment.shop_url` (string)
    Shop URL with protocol HTTP or HTTPS

  - `data.payment.session` (object)

  - `data.payment.session.expires_at` (string, required)
    UTC date time format

  - `data.payment.session.redirect_url` (string, required)

  - `data.payment.products` (array, required)
    Expected at least 1 product

  - `meta` (object, required)

  - `meta.next_prev_id` (string)

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)

## Response 500 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)