---
title: "Retrieve a paginated and filtered list of transactions of specific business account product"
method: GET
path: "/v1/transactions"
tags: ["Transaction"]
---

# Retrieve a paginated and filtered list of transactions of specific business account product

`GET /v1/transactions`

This endpoint retrieves a paginated list of transactions associated with a specific business account product (retrieved from API Key). 
It supports filtering by transaction_ids, user_ids, currencies multi-select filters and creation date filters.
Intended for use in the partner portal.

## Query parameters

- `filters` object, required
  - `transaction_ids` integer[]
  - `currencies` string[]
  - `creation_date` object, required — Defines a date range where the difference between the from and to dates must not exceed 90 days.
    - `from` string, date-time, required
    - `to` string, date-time, required
- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

OK

- PaginatedTransactionsListResponseV1 — List of transactions found with pagination payload included
  - `status` string, required
  - `result` object, required
    - `pagination` object, required
      - `total` integer, required — Total number of transactions matching the applied filters
    - `items` object[], required — Array of transactions found
      - `transaction_id` integer, required
      - `payment_id` string, required
      - `user_id` string
      - `event_id` string, required
      - `fiat_amount` object, required
        - `amount` string, required
        - `currency` string, required
      - `crypto_amount` object, required
        - `amount` string, required
        - `currency` string, required
      - `merchant` string, required
      - `wallet_address` object, required
        - `address` string, required
        - `currency` string, required
      - `exchange_rate_fiat_to_crypto` ExchangeRateNullableV1, nullable — Exchange rate for single currency pair
        - `from` string, required — currency code or assetId
        - `to` string, required — currency code or assetId
        - `rate` string, required
      - `exchange_rate_crypto_to_fiat` ExchangeRateNullableV1, nullable — Exchange rate for single currency pair
        - `from` string, required — currency code or assetId
        - `to` string, required — currency code or assetId
        - `rate` string, required
      - `balance_histories` BalanceHistoryV1[], required
        - `transaction_id` string, required
        - `transaction_type` string, required
        - `business_account_id` integer, required
        - `amount` object, required
          - `amount` string, required
          - `currency` string, required
        - `available_balance_after` object, required
          - `amount` string, required
          - `currency` string, required
        - `hold_balance_after` object, required
          - `amount` string, required
          - `currency` string, required
        - `transaction_details` object, required
          - `reference_id` string, required
          - `description` string, required
        - `timestamp` integer, required
      - `receiver_id` string, required
      - `created_at` string, date-time, required — Transaction created date time in ISO 8601 full-time format.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/payb/apis/widget.md) · [All operations](https://skmtc.dev/payb/apis/widget/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payb/widget/revisions/2c2cf39656c5/schema)