---
title: "List available dedicated lines"
method: GET
path: "/lines"
---

# List available dedicated lines

`GET /lines`

## Request

- Base URL: `https://osis.co/api/v1/comms`
- URL: `https://osis.co/api/v1/comms/lines`
- Auth: HTTP bearer

See which dedicated numbers you can claim. This has to be turned on for your workspace, or you get 403 line_claim_not_allowed. Scope: `comms_lines_read`.

## Response `200`

Available lines

- object
  - `lines` object[]
    - `e164` string
    - `status` string
    - `capabilities` object
      - `imessage` boolean
      - `sms` boolean
      - `sms_fallback` boolean
      - `attachments` boolean

## Other responses

- `401`: API key is missing or wrong
- `403`: Your key doesn't have the scope this needs

---

[API](https://skmtc.dev/osis/apis/comms-api.md) · [All operations](https://skmtc.dev/osis/apis/comms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/osis/apis/comms-api/revisions/59a4c0ba8936?raw)