BSV blockchainBSV blockchain

listActions

POST/listActions

Lists all transactions matching the specified labels

Body application/json

labelsstring[]
labelQueryMode"any" | "all"
includeLabelsboolean
includeInputsboolean
includeInputSourceLockingScriptsboolean
includeInputUnlockingScriptsboolean
includeOutputsboolean
includeOutputLockingScriptsboolean
limitnumber
offsetnumber
seekPermissionboolean

Response

The list of actions

totalActionsnumber
actionsobject[]
Show actions properties
txidstring
satoshisnumber
status"completed" | "unprocessed" | "sending" | "unproven" | "unsigned" | "nosend" | "nonfinal"
isOutgoingboolean
descriptionstring
labelsstring[]
versionnumber
lockTimenumber
inputsobject[]
Show inputs properties
sourceOutpointstring
sourceSatoshisnumber
sourceLockingScriptstring
unlockingScriptstring
inputDescriptionstring
sequenceNumbernumber
outputsobject[]
Show outputs properties
satoshisnumber
lockingScriptstring
spendableboolean
customInstructionsstring
tagsstring[]
outputIndexnumber
outputDescriptionstring
basketstring

Invalid input

Internal server error

Request
curl -X POST "http://localhost:3321/listActions" \
  -H "Content-Type: application/json" \
  -d '{
  "labels": [
    "string"
  ],
  "labelQueryMode": "any",
  "includeLabels": true,
  "includeInputs": true,
  "includeInputSourceLockingScripts": true,
  "includeInputUnlockingScripts": true,
  "includeOutputs": true,
  "includeOutputLockingScripts": true,
  "limit": 0,
  "offset": 0,
  "seekPermission": true
}'
Response
{
  "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"
        }
      ]
    }
  ]
}