# Tel

URL: https://docs.hanzo.ai/docs/cli/tel

> The `hanzo tel` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/tel) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/tel) · [SDKs](https://docs.hanzo.ai/docs/sdks)

The telecommunications surface: phone numbers, calls and messages, on whatever carrier the deployment is configured for.

[API reference →](https://docs.hanzo.ai/docs/openapi/tel)

```bash
hanzo tel calls list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command             | What it does                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------- |
| `hanzo tel summary` | Counts what this org holds on the telephony plane: its numbers, its calls and its messages. |

### Calls

| Command                   | What it does                                                   |
| ------------------------- | -------------------------------------------------------------- |
| `hanzo tel calls create`  | Dials.                                                         |
| `hanzo tel calls list`    | Lists the calls this org has placed or received, newest first. |
| `hanzo tel calls rm <id>` | Ends a call this org placed.                                   |

### Messages

| Command                     | What it does                                                    |
| --------------------------- | --------------------------------------------------------------- |
| `hanzo tel messages create` | Sends a message from one of this org's own numbers.             |
| `hanzo tel messages get`    | Lists the messages this org has sent or received, newest first. |

### Numbers

| Command                       | What it does                                                                      |
| ----------------------------- | --------------------------------------------------------------------------------- |
| `hanzo tel numbers available` | Asks the carrier what is available to buy.                                        |
| `hanzo tel numbers create`    | Provisions with the carrier FIRST and records second.                             |
| `hanzo tel numbers list`      | Lists the phone numbers this org HOLDS — the ones it has bought and not released. |
| `hanzo tel numbers rm <id>`   | Checks the holding is THIS org's before it reaches the carrier.                   |