---
title: "List of all user transactions"
method: GET
path: "/operations"
tags: ["transaction"]
---

# List of all user transactions

`GET /operations`

## Request

- Base URL: `https://plisio.loc/api/v1`
- URL: `https://plisio.loc/api/v1/operations`
- Auth: API key in query parameter `api_key`

## Query parameters

- `page` integer
- `limit` integer
- `shop_id` string
- `type` 'cash_in' | 'cash_out' | 'mass_cash_out' | 'invoice'
- `status` 'pending' | 'completed' | 'error' | 'new' | 'expired' | 'mismatch' | 'cancelled'
- `currency` string
- `search` string

## Response `200`

Returns OperationsApiResponseDto object

- OperationsApiResponseDto
  - `status` string: success or error
  - `data` OperationsHateoasResponseDto[]
    - `status` string: success or error
    - `operations` OperationDto[]
      - `user_id` string: Profile ID
      - `shop_id` string: Shop ID
      - `type` string: cash_in, cash_out, mass_cash_out, invoice
      - `status` string: pending, completed, error, new, expired, mismatch, cancelled
      - `pending_sum` string: unconfirmed amount (mempool)
      - `psys_cid` string: ID column from https://plisio.net/documentation/appendices/supported-cryptocurrencies
      - `currency` string: Code column from https://plisio.net/documentation/appendices/supported-cryptocurrencies
      - `source_currency` string: fiat currency - USD by default or source_currency was set
      - `source_rate` string: Exchange rate from the “psys_cid” to the “source_currency” at the moment of transfer
      - `fee` string: transaction fee stated in the transfer
      - `wallet_hash` string: destination hash (type=cash_out) or invoice hash
      - `sendmany` string[]: Pairs of hashes and values (type=mass_cash_out)
      - `params` OperationParamsDto
        - `fee` FeeParamsDto
          - `conf_target` string: estimated fee parameter to confirm the transaction in the “conf_target” blocks
          - `plan` string: the Plisio’s fee plan name
          - `value` string: fee value
        - `order_number` string: Invoice order number. Must be unique number in your store for each new store`s order!!!
        - `order_name` string: Order name
        - `description` string: Order description
        - `source_amount` string: Invoice amount in fiat currency
        - `source_currency` string: Invoice fiat currency
        - `value` string: fee value
        - `avatar` string: Custom invoice avatar
        - `store` string: Custom invoice store name
        - `currency` string: Code column from https://plisio.net/documentation/appendices/supported-cryptocurrencies
        - `psys_cid` string: ID column from https://plisio.net/documentation/appendices/supported-cryptocurrencies
        - `amount` string: Invoice amount in selected cryptocurrency
        - `source_rate` string: Cryptocurrency rate
        - `email` string: Email of payer
        - `donate_hash` string: Donation hash
        - `payment_button_hash` string: Payment button hash
        - `memo` unknown
      - `expire_at_utc` integer: timestamp in UTC timezone; it may need to be divided by 1000
      - `created_at_utc` integer: timestamp in the UTC timezone; it may need to be divided by 1000
      - `amount` string: amount received/transferred by an operation (invoice, cash-in/cash-out)
      - `sum` string: Invoice: params.amount + Plisio commission (if customer pays commission) or params.amount (if merchant pays commission) Cash-out: transfer amount + network fee Cash-in: received amount
      - `commission` string: Plisio commission
      - `tx_url` string: link to the cryptocurrency block explorer
      - `tx_id` string[]: array of transaction ids
      - `id` string: internal Plisio operation ID
      - `actual_sum` string: Real incoming amount
      - `actual_commission` string: Plisio commission taken
      - `actual_fee` string: Network fee (move invoice to wallet)
      - `actual_invoice_sum` string: actual_sum - actual_commis_sim - actual_fee
      - `tx` object[]: array of transaction payment items
      - `confirmations` integer: Number of confirmations of this transaction. We don't update confirmation after operation is confirmed
      - `status_code` integer: Status code
      - `parent_id` string: ID of parent invoice
    - `_links` HateoasLinksDto
      - `self` HateoasLinkDto
        - `href` string, uri
      - `next` HateoasLinkDto
        - `href` string, uri
      - `last` HateoasLinkDto
        - `href` string, uri
    - `_meta` HateoasMetaDto
      - `totalCount` integer: HATEOAS pagination items count
      - `pageCount` integer: HATEOAS pagination pages count
      - `currentPage` integer: HATEOAS pagination current page
      - `perPage` integer: HATEOAS pagination items per page

## Other responses

- `401`: Returns error
- `404`: Returns error
- `422`: Returns error
- `500`: Returns error

---

[API](https://skmtc.dev/plisio/apis/plisio-api-plisio-loc.md) · [All operations](https://skmtc.dev/plisio/apis/plisio-api-plisio-loc/llms.txt) · [OpenAPI document](https://skmtc.dev/plisio/apis/plisio-api-plisio-loc/revisions/b54f70a29304?raw)