---
title: "Get transactions list"
method: GET
path: "/v2/transactions"
tags: ["Transaction"]
---

# Get transactions list

`GET /v2/transactions`

Get transactions list

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `email` string
- `partnerUserId` string
- `invoices[]` string[]
- `requestIds[]` string[]
- `partnerTransactionId` string
- `gateways[]` string[]
- `statuses[]` string[]
- `currencies[]` string[]
- `countries[]` string[]
- `amountCrypto` number
- `amountUsd` number
- `limit` number
- `cursor` string

## Response `200`

Transactions list for partner

- object — Transactions list for partner
  - `data` object[] — Transactions
    - `id` string — Transaction ID
    - `gateway` 'fiat_to_crypto' | 'crypto_to_fiat'
    - `status` 'created' | 'completed' | 'cancelled' | 'payment_error' | 'rejected' — Transaction status
    - `from` object — Transaction payment/payout method
      - `name` string — Method name
      - `asset` object, nullable — Asset for current method (only for crypto methods)
        - `id` string — Asset ID for current method
        - `name` string — Asset name for current method
        - `currency` object
          - `code` string — Currency code for asset
        - `blockchain` object
          - `name` string — Blockchain name for asset
          - `network` string — Blockchain network for asset
      - `address` string, nullable — User address for crypto method
      - `destinationTag` string, nullable — User destination tag for crypto method
    - `to` object — Transaction payment/payout method
      - `name` string — Method name
      - `asset` object, nullable — Asset for current method (only for crypto methods)
        - `id` string — Asset ID for current method
        - `name` string — Asset name for current method
        - `currency` object
          - `code` string — Currency code for asset
        - `blockchain` object
          - `name` string — Blockchain name for asset
          - `network` string — Blockchain network for asset
      - `address` string, nullable — User address for crypto method
      - `destinationTag` string, nullable — User destination tag for crypto method
    - `exchangeRate` object, nullable
      - `currencyTo` object — Transaction amount
        - `amount` string — Amount value
        - `currency` string — Amount currency
      - `currencyFrom` object — Transaction amount
        - `amount` string — Amount value
        - `currency` string — Amount currency
    - `hash` string, nullable — Transaction hash (only for completed transaction)
    - `explorerLink` string, nullable — Explorer link (only for completed transaction)
    - `createdAt` string, date-time — Transaction created date time in ISO 8601 full-time format.
    - `paidAt` string, date-time, nullable — Transaction paid date time in ISO 8601 full-time format.
    - `completedAt` string, date-time, nullable — Transaction completed date time in ISO 8601 full-time format.
    - `amounts` object — Transaction amounts
      - `spentOriginal` object — Transaction amount
        - `amount` string — Amount value
        - `currency` string — Amount currency
      - `spentFiat` object — Transaction amount
        - `amount` string — Amount value
        - `currency` string — Amount currency
      - `receivedOriginal` object — Transaction amount
        - `amount` string — Amount value
        - `currency` string — Amount currency
      - `receivedFiat` object — Transaction amount
        - `amount` string — Amount value
        - `currency` string — Amount currency
    - `fees` object — Transaction fees
      - `paybisFee` object, nullable — Transaction fee
        - `amount` string — Fee value
        - `currency` string — Fee currency
      - `paymentFee` object, nullable — Transaction fee
        - `amount` string — Fee value
        - `currency` string — Fee currency
      - `networkFee` object, nullable — Transaction fee
        - `amount` string — Fee value
        - `currency` string — Fee currency
      - `partnerFee` object, nullable — Transaction fee
        - `amount` string — Fee value
        - `currency` string — Fee currency
      - `partnerFeeFiat` object, nullable — Transaction fee
        - `amount` string — Fee value
        - `currency` string — Fee currency
    - `user` object — User for current transaction
      - `id` string, nullable — User ID in partner system
      - `email` string — User email
      - `country` object, nullable — User country for current transaction
        - `name` string — User country name
        - `code` string — User country code
    - `request` object — Request for current transaction
      - `id` string, uuid, nullable — Request ID
      - `flow` 'buyCrypto' | 'sellCrypto', nullable — Transaction flow for request
      - `partnerTransactionId` string, nullable — The transaction ID in your system to associate the request with.
      - `createdAt` string, date-time, nullable — Request created date time in ISO 8601 full-time format.
  - `meta` object — Meta info
    - `limit` number — Current limit
    - `currentCursor` string, nullable — Current pagination cursor
    - `nextCursor` string, nullable — Next pagination cursor

## Other responses

- `401` — API key is missing
- `403` — Invalid API key or access disabled
- `422` — Validation error
- `503` — Maintenance status

---

[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)