# `jadpo routes`

List every route.

List every route the project answers (area 7), grouped by API: its method and full path, the query or action it runs, its authentication and the file it is written in. Authentication is required, none (anyone may call it) or fresh (the caller's record is read now).

```text
jadpo routes
```

## On every command

- `--json`: Print data for tools instead of text
- `--full`: Show everything a report shortens
- `--help`: Show every flag, with examples
- `--color <when>`: Choose when to use colour

`jadpo routes --json` writes one JSON document to standard output instead of text, with the same exit code. The document has `schemaVersion`, `command` (`"routes"`), `ok`, `data` (what the command produced, `null` when it failed) and `diagnostics` (each error with its `rule`, `reason`, `next` and `help`). A command that needs a terminal refuses `--json` and names the flags that do the same job.

## Examples

```text
# List the routes of the project you are in
jadpo routes
# Print them as data for tools
jadpo routes --json
```

## Errors

- [`cli.routes_arguments`](/docs/errors/cli.routes_arguments.md): A `jadpo routes` command is given an argument, which it doesn't take
- [`toolchain.project_not_found`](/docs/errors/toolchain.project_not_found.md): You ran a command that works on a project in a folder with no `app.jadpo`, in it or in any folder above it