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

# List available lines

> GET /api/v1/comms/lines — list dedicated numbers currently free to claim.

List dedicated iMessage/SMS numbers that are free to [claim](/messages-api/claim-line).

This endpoint is allowlisted. Accounts that are not on the list receive `403`.

**Scope:** `comms_lines_read`

## Request

```bash theme={null}
curl "https://osis.co/api/v1/comms/lines" \
  -H "Authorization: Bearer $COMMS_API_KEY"
```

## Response

```json theme={null}
{
  "lines": [
    {
      "e164": "+16285551212",
      "status": "active",
      "capabilities": {
        "imessage": true,
        "sms": true,
        "sms_fallback": true,
        "attachments": false
      }
    }
  ]
}
```

Claim one of those numbers with `POST /api/v1/comms/lines/claim` and `{ "e164": "+16285551212" }`.

## Errors

| Status | Code                     | When                                                    |
| ------ | ------------------------ | ------------------------------------------------------- |
| `403`  | `line_claim_not_allowed` | This account cannot list or claim lines through the API |