---
title: "List team phone numbers"
method: GET
path: "/numbers"
tags: ["numbers"]
---

# List team phone numbers

`GET /numbers`

Retrieves the list of phone numbers provisioned for your team. Each number includes its assignment (user, IVR, conference, fax, or unassigned), country, and configuration. The total count is in the `list_count` field.

Five boolean filters allow you to select numbers by assignment type. By default, `is_available` is `true` and all others are `false`. Set a filter to `true` to include that category. If `is_available` is `false`, at least one other filter must be `true`.

**Permission:** `Numbers Read` required.

**Monitoring impact:**
- **OFF:** Returns only **your own** numbers (numbers assigned to your user). All filter parameters are **ignored** — the response always contains your numbers regardless of filters.
- **ON:** Returns **all team numbers** with full filter support (`is_ivr`, `is_user`, `is_conference`, `is_fax`, `is_available`).

## Query parameters

- `is_user` boolean
- `is_ivr` boolean
- `is_fax` boolean
- `is_conference` boolean
- `is_available` boolean

## Response `200`

Successful operation — returns the list of numbers.

- NumberList
  - `list_count` integer — The size of the list
  - `list` Number[]
    - `number` integer — Phone number in E.164 format without the `+` prefix (e.g., `33612345678`).
    - `label` string — The label of the number
    - `type` string — The type of the number
    - `user_id` integer — The user identifier
    - `ivr_id` integer — The unique identifier of the IVR. Use `GET /ivrs` to discover available IVR IDs.
    - `conference_id` integer — The conference identifier
    - `is_sms` boolean
    - `is_sms_write` boolean
    - `is_callable` boolean
    - `format` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean

## Other responses

- `204` — No numbers found matching the given filters.
- `400` — Invalid query parameter value.
- `401` — Unauthorized — invalid or missing API token, or missing `Numbers Read` permission.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)