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

# Phone numbers

> List sender numbers assigned to your tenant.

Use this endpoint before `POST /api/v1/chats`. Pass one returned `phone_number` as the `from` value.
Use `phone_line_id` when an endpoint lets you pin a send to a specific sender line.

## Request

```bash theme={null}
curl https://console.trychert.com/api/v1/phone-numbers \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET"
```

## Response

```json theme={null}
{
  "phone_numbers": [
    {
      "id": "pl_01H...",
      "phone_line_id": "pl_01H...",
      "phone_number": "+15555550100",
      "service": "imessage",
      "is_active": true,
      "capabilities": ["imessage", "send", "receive"]
    }
  ]
}
```

## Fields

| Field           | Meaning                                                    |
| --------------- | ---------------------------------------------------------- |
| `id`            | Stable Chert phone-line id. Same value as `phone_line_id`. |
| `phone_line_id` | Use this with request fields named `phone_line_id`.        |
| `phone_number`  | E.164 sender number. Use this as `from` in Chats.          |
| `service`       | Currently `imessage` for Chert-managed sends.              |
| `is_active`     | Whether the number can currently participate in messaging. |
| `capabilities`  | `send`, `receive`, `imessage`, and future service flags.   |

Chert pins a sender line after the first successful conversation with a recipient. Follow-ups reuse that line automatically.

## See also

* [Create a chat](/api/chats/create)
* [Sending](/api/sending)