---
title: "List phone numbers"
method: GET
path: "/accounts/{user_id}/numbers"
tags: ["Numbers"]
---

# List phone numbers

`GET /accounts/{user_id}/numbers`

List your purchased/assigned phone numbers. For corporate members all assigned numbers will be returned, while for the corporate admin, all purchased numbers. (Permitted scopes: **fax:all:read**, **fax:numbers:read**)

## Path parameters

- `user_id` string, required

## Response `200`

Response containing a list of number objects

- NumberList — List of numbers
  - `numbers` Number[], required
    - `acquired_date` string, required — Date and time at which the number was acquired
    - `assigned_to` string[], required — IDs of the user to whom this number is assigned
    - `expiration_date` string — Number expiration date, might be blank
    - `id` string, required — Number ID
    - `is_canceled` boolean — True if number is canceled but not yet deleted
    - `notifications` object[]
      - `email` boolean
      - `push_notification` boolean
      - `type` string
    - `number` string, required — Fax number
    - `owner_id` string, required — Number owner ID
    - `status` 'waiting_verification' | 'active', required — Status of your fax number e.g. active, inactive.

## Other responses

- `400` — Error object in case there's a problem with given data
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/revisions/c1afc85d2c15/schema)