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

# Output formats

> Pretty tables for reading, JSON for scripting, TOON for AI agents and quiet mode for shell pipelines.

Every command accepts the same four output flags. They are global, so they are left out of the
per-command flag tables in the [command reference](/cli-reference/overview).

| Flag      | Output                                                                           |
| --------- | -------------------------------------------------------------------------------- |
| *(none)*  | A pretty table or record, plus suggested follow-up commands                      |
| `--json`  | A JSON envelope with `data`, and `pagination` and `breadcrumbs` where they apply |
| `--quiet` | The raw response body only, with no envelope                                     |
| `--toon`  | TOON, a compact encoding aimed at AI agents                                      |

## Pretty output

With no flag and a terminal attached, listings render as a table and single records as a
key-value block, followed by a short list of commands you are likely to want next.

```bash theme={"system"}
neetodesk tickets list
```

Column choice depends on the fields the response carries and on your terminal width, so treat
the table as something to read rather than something to parse.

## JSON

```bash theme={"system"}
neetodesk tickets list --json
```

```json theme={"system"}
{
  "data": {
    "tickets": [
      {
        "id": "0f1e4c9a-6d3b-4f92-8a71-25b0c8d4e6f3",
        "number": 1042,
        "subject": "Refund not received",
        "status": "open",
        "priority": "high",
        "category": "Billing",
        "created_at": "2026-08-03T09:14:22.000Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total_count": 137
  },
  "breadcrumbs": [
    { "label": "Show", "command": "neetodesk tickets show <id>" }
  ]
}
```

The envelope is also what you get when output is piped or redirected, because the CLI drops
pretty formatting when standard output is not a terminal. `neetodesk tickets list > out.json`
therefore writes JSON without needing `--json`.

## Quiet

`--quiet` prints the response body on its own, with no envelope, no pagination and no
breadcrumbs:

```bash theme={"system"}
neetodesk tickets list --quiet | jq '.tickets[].number'
```

On commands that create or update a record, quiet mode prints just the identifier, which makes
it easy to capture:

```bash theme={"system"}
ticket_id=$(neetodesk tickets create \
  --email customer@example.com \
  --subject "Refund not received" \
  --description "Card was charged twice." \
  --quiet)
```

## TOON

`--toon` emits TOON, an indentation-based encoding that carries the same data in fewer tokens
than JSON. It is intended for AI assistants reading command output:

```bash theme={"system"}
neetodesk tickets list --toon
```

See [AI assistants](/cli/ai-assistants) for how the CLI plugs into Claude, Cursor and the rest.