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

# tm billing pricing serverless list

> List serverless pricing (GET /v1/billing/serverless-pricing).

## When To Use This

Use `tm billing pricing serverless list` when you have Control Plane access for the current Tensormesh environment and need to discover published serverless model names.

Use the returned `pricing[].model` value as the `--model` input for `tm infer chat`, the SDK, or raw HTTP requests.

Example response shape:

```yaml theme={null}
pricing:
  - name: MiniMaxAI/MiniMax-M2.5
    model: MiniMaxAI/MiniMax-M2.5
    isActive: true
```

Use `model` when sending inference requests. `id` is the pricing-record id, and `name` is display-oriented.

## Usage

```sh theme={null}
tm billing pricing serverless list [OPTIONS]
```

## Examples

### List published serverless pricing records.

```sh theme={null}
tm billing pricing serverless list
```

### Inspect only active pricing records and copy `pricing[].model` from structured output.

```sh theme={null}
tm --output json billing pricing serverless list --active-only
```

### Filter the pricing list to one known serverless model name.

```sh theme={null}
tm billing pricing serverless list --model MiniMaxAI/MiniMax-M2.5
```

## Options

| Name            | Type      | Required | Default | Details                                   |
| --------------- | --------- | -------- | ------- | ----------------------------------------- |
| `--model`       | `text`    | no       |         | Filter by model name.                     |
| `--active-only` | `boolean` | no       | `false` | Return active pricing only. Boolean flag. |
| `--timeout`     | `float`   | no       |         | HTTP timeout in seconds.                  |

## Inherited Global Options

| Name                  | Type           | Required | Default                              | Details                                                                                                                      |          |    |          |                                                                   |
| --------------------- | -------------- | -------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | -------- | -- | -------- | ----------------------------------------------------------------- |
| `--version`, `-V`     | `boolean`      | no       | `false`                              | Show the version and exit. Boolean flag.                                                                                     |          |    |          |                                                                   |
| `--config`            | `path`         | no       | `"~/.config/tensormesh/config.toml"` | Path to config TOML file                                                                                                     |          |    |          |                                                                   |
| `--output`            | \`choice\[text | json     | yaml                                 | raw                                                                                                                          | table]\` | no | `"text"` | Output format (text is human-readable; json is machine-friendly). |
| `--quiet`             | `boolean`      | no       | `false`                              | Suppress non-essential output. Boolean flag.                                                                                 |          |    |          |                                                                   |
| `--debug`             | `boolean`      | no       | `false`                              | Print debug logs to stderr (secrets redacted). Boolean flag.                                                                 |          |    |          |                                                                   |
| `--ca-bundle`         | `path`         | no       |                                      | Path to a PEM CA bundle for TLS verification (overrides TENSORMESH\_CA\_BUNDLE).                                             |          |    |          |                                                                   |
| `--max-retries`       | `integer`      | no       |                                      | Max retries for idempotent HTTP requests on transient errors (overrides TENSORMESH\_MAX\_RETRIES; subcommands may override). |          |    |          |                                                                   |
| `--controlplane-base` | `text`         | no       |                                      | Override the Control Plane base URL.                                                                                         |          |    |          |                                                                   |

## Prerequisites

* Run `tm auth login` first, or otherwise provide Control Plane auth for the same Tensormesh environment you want to inspect.

## Caveats

* This command lists pricing records for the current Tensormesh Control Plane environment. If you are targeting a different serverless host override, confirm the model name for that host separately.

## Related Commands

* [`tm infer chat`](/cli/reference/infer/chat)
* [`tm auth whoami`](/cli/reference/auth/whoami)

## Parent Command

* [`tm billing pricing serverless`](/cli/reference/billing/pricing/serverless)