# JSON output (/docs/reference/json-output)

The --json contract: fields, schemaVersion, NDJSON and errors.

This page is the contract of `--json`, for scripts that read turno's output. Commands that only read take `--json`; `turno help json` prints the same text.

```text title="turno help json"
JSON output. Read commands take --json:

  --json          every field, as one indented document
  --json=fields   the field names, one per line, and nothing else
  --json=a,b      only those fields; an unknown one is a usage error (exit 2)
                  that lists the known ones
  --watch --json  one compact JSON record per line (NDJSON) until Ctrl-C (turno
                  limit show, turno mcp top); turno mcp log --follow --json too

Every object carries schemaVersion, and so does each element of a list. A version
goes up only when a field is removed or renamed or changes meaning (the changelog
says so); new fields keep it. Errors under --json are JSON on stderr (turno help
exit-codes). turno config get prints a config value as it is in config.toml.

Examples:
  $ turno status --json=fields
  $ turno profile list --json=name,email
  $ turno limit show --watch --json | jq -c '.fiveHour'
```