---
title: "Lists all transactions matching the specified labels"
method: POST
path: "/listActions"
tags: ["HTTPWalletJSON"]
---

# Lists all transactions matching the specified labels

`POST /listActions`

## Request body

- ListActionsArgs
  - `labels` string[]
  - `labelQueryMode` 'any' | 'all'
  - `includeLabels` boolean
  - `includeInputs` boolean
  - `includeInputSourceLockingScripts` boolean
  - `includeInputUnlockingScripts` boolean
  - `includeOutputs` boolean
  - `includeOutputLockingScripts` boolean
  - `limit` number
  - `offset` number
  - `seekPermission` boolean

## Response `200`

The list of actions

- ListActionsResult
  - `totalActions` number
  - `actions` WalletAction[]
    - `txid` string
    - `satoshis` number
    - `status` 'completed' | 'unprocessed' | 'sending' | 'unproven' | 'unsigned' | 'nosend' | 'nonfinal'
    - `isOutgoing` boolean
    - `description` string
    - `labels` string[]
    - `version` number
    - `lockTime` number
    - `inputs` WalletActionInput[]
      - `sourceOutpoint` string
      - `sourceSatoshis` number
      - `sourceLockingScript` string
      - `unlockingScript` string
      - `inputDescription` string
      - `sequenceNumber` number
    - `outputs` WalletActionOutput[]
      - `satoshis` number
      - `lockingScript` string
      - `spendable` boolean
      - `customInstructions` string
      - `tags` string[]
      - `outputIndex` number
      - `outputDescription` string
      - `basket` string

## Other responses

- `400` — Invalid input
- `500` — Internal server error

---

[API](https://skmtc.dev/bsv-blockchain/apis/wallet-json-api.md) · [All operations](https://skmtc.dev/bsv-blockchain/apis/wallet-json-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bsv-blockchain/wallet-json-api/revisions/4b04a6edb128/schema)