# listActions

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**POST** `/listActions`

Base URL: `http://localhost:3321`

Lists all transactions matching the specified labels

## Body

Content type: `application/json`

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

Example:

```json
{
  "labels": [
    "string"
  ],
  "labelQueryMode": "any",
  "includeLabels": true,
  "includeInputs": true,
  "includeInputSourceLockingScripts": true,
  "includeInputUnlockingScripts": true,
  "includeOutputs": true,
  "includeOutputLockingScripts": true,
  "limit": 0,
  "offset": 0,
  "seekPermission": true
}
```

## Responses

### 200

The list of actions

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

Example:

```json
{
  "totalActions": 0,
  "actions": [
    {
      "txid": "string",
      "satoshis": 0,
      "status": "completed",
      "isOutgoing": true,
      "description": "string",
      "labels": [
        "string"
      ],
      "version": 0,
      "lockTime": 0,
      "inputs": [
        {
          "sourceOutpoint": "string",
          "sourceSatoshis": 0,
          "sourceLockingScript": "string",
          "unlockingScript": "string",
          "inputDescription": "string",
          "sequenceNumber": 0
        }
      ],
      "outputs": [
        {
          "satoshis": 0,
          "lockingScript": "string",
          "spendable": true,
          "customInstructions": "string",
          "tags": [
            "string"
          ],
          "outputIndex": 0,
          "outputDescription": "string",
          "basket": "string"
        }
      ]
    }
  ]
}
```

### 400

Invalid input

### 500

Internal server error