> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flavors

> List available compute flavors (instance types).

Flavors define the hardware configuration available for compute instances — including CPU, memory, and GPU specifications.

## Subcommands

* [list](#list) — List flavors

***

## list

List the flavors in a region, including pinned-only ones. If you omit `--region`, the CLI opens an interactive picker, so always pass it in scripts.

The table shows each flavor's ID, name, architecture, CPU count, memory, disk, whether it is pinned-only, and its GPUs.

**Aliases:** `list`, `ls`

```bash theme={null}
nscale flavors list --region <region-id> [flags]
```

### Flags

<table>
  <thead><tr><th>Flag</th><th>Description</th></tr></thead>

  <tbody>
    <tr><td>`--org string`</td><td>Organization ID or name</td></tr>
    <tr><td>`--region string`</td><td>Region ID or name</td></tr>

    <tr>
      <td>
        `--json`
      </td>

      <td>Emit the full JSON payload (mutually exclusive with `-q`)</td>
    </tr>

    <tr>
      <td>
        `-q, --query stringArray`
      </td>

      <td>jq filter for value extraction (see [Query output with `-q`](https://docs.nscale.com/docs/cli/query-output))</td>
    </tr>

    <tr>
      <td>
        `--limit int`
      </td>

      <td>Show at most N results (client-side; every result is still fetched). Cuts before `-q`. `0` for all</td>
    </tr>
  </tbody>
</table>

### Pinned-only flavors

A pinned-only flavor is reservation-only: a server using it must target a specific host, so instances and on-demand node pools can't use it. These flavors show `yes` in the **Pinned** column and have `spec.pinnedOnly` set to `true` in JSON output. The interactive flavor pickers for [instances](https://docs.nscale.com/docs/cli/instances.md#create) and [compute node pools](https://docs.nscale.com/docs/cli/kubernetes.md#nodepool-create) leave them out.

To list only the flavors an instance can use:

```bash theme={null}
nscale flavors list --region <region-id> \
  -q '.[] | select(.spec.pinnedOnly != true) | .metadata.id'
```

### Examples

```bash theme={null}
# List all flavors in a region
nscale flavors list --org <org-id> --region <region-id>

# Output as JSON
nscale flavors list --org <org-id> --region <region-id> --json
```
