# listOutputs

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

**POST** `/listOutputs`

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

Lists the spendable outputs kept within a specific basket

## Body

Content type: `application/json`

- `basket` (string)
- `tags` (string[])
- `tagQueryMode` ("all" | "any")
- `include` ("locking scripts" | "entire transactions")
- `includeCustomInstructions` (boolean)
- `includeTags` (boolean)
- `includeLabels` (boolean)
- `limit` (number)
- `offset` (number)
- `seekPermission` (boolean)

Example:

```json
{
  "basket": "string",
  "tags": [
    "string"
  ],
  "tagQueryMode": "all",
  "include": "locking scripts",
  "includeCustomInstructions": true,
  "includeTags": true,
  "includeLabels": true,
  "limit": 0,
  "offset": 0,
  "seekPermission": true
}
```

## Responses

### 200

The list of outputs

- `totalOutputs` (number)
- `BEEF` (number[])
- `outputs` (object[])
  - `satoshis` (number)
  - `lockingScript` (string)
  - `spendable` (boolean)
  - `customInstructions` (string)
  - `tags` (string[])
  - `outpoint` (string)
  - `labels` (string[])

Example:

```json
{
  "totalOutputs": 0,
  "BEEF": [
    0
  ],
  "outputs": [
    {
      "satoshis": 0,
      "lockingScript": "string",
      "spendable": true,
      "customInstructions": "string",
      "tags": [
        "string"
      ],
      "outpoint": "string",
      "labels": [
        "string"
      ]
    }
  ]
}
```

### 400

Invalid input

### 500

Internal server error