---
title: "nextmail languages"
description: "Every command in this namespace, with its arguments, flags and examples."
url: "https://nextmail.sh/docs/cli/reference/languages"
area: "CLI"
category: "Reference"
---

# nextmail languages

Every command in this namespace, with its arguments, flags and examples.

## Commands

### `nextmail languages list`

List every language a message can be sent in

```bash
nextmail languages list [flags]
```

Returns the whole language table in one response, with no cursor. It sits behind a key like every other endpoint but needs no scope, because it names no data belonging to anybody. The table is around two hundred rows and changes a handful of times a year, so fetch it once and keep it.

The order is meaningful. The languages people are most likely to be emailed in come first, then regional variants, then the rest by region. A picker should render the rows in the order they arrive until somebody types, then search `native`, `label` and `code` together. Show `native` first, since it is the word someone looking for their own language is scanning for, and never show `flag` on its own: a flag names a country, not a language.

Any row's `code`, `label` or `native` is accepted by `translate.to` on `emails.send` and by `emails.translate`. The package also ships the same table as `LANGUAGES` with `resolveLanguage`, which is useful before the first request, while this call returns the server's current rows.

- Needs a sign-in.
- Aliases: `ls`.

**Examples**

```bash
nextmail languages list
```

Print the raw JSON

```bash
nextmail languages list --json
```

Also available in: API [`GET /languages`](https://nextmail.sh/docs/api/reference/languages#get-languages); TypeScript [`nextmail.languages.list()`](https://nextmail.sh/docs/sdk/reference/languages#list); Python [`languages.list()`](https://nextmail.sh/docs/python/reference/languages#list); Ruby [`languages.list`](https://nextmail.sh/docs/ruby/reference/languages#list); PHP [`languages->list`](https://nextmail.sh/docs/php/reference/languages#list); Go [`Languages.List`](https://nextmail.sh/docs/go/reference/languages#list); Java [`languages().list`](https://nextmail.sh/docs/java/reference/languages#list); C# [`Languages.ListAsync`](https://nextmail.sh/docs/csharp/reference/languages#list).