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

# List phone numbers

`GET /numbers`

Lists all phone numbers assigned to a workspace.

## Query parameters

- `workspace` string, required
- `limit` integer
- `offset` integer
- `is_available` boolean

## Headers

- `Authorization` string, required

## Response `200`

200

- PhoneNumbersGetNumbersResponse200
  - `status` string — Whether the request was successful.
  - `response` NumbersGetResponsesContentApplicationJsonSchemaResponse
    - `pagination` NumbersGetResponsesContentApplicationJsonSchemaResponsePagination
      - `total_records` integer — Total number of phone numbers.
      - `limit` integer — Number of phone numbers per page.
      - `offset` integer — Index of the first phone number returned.
    - `phone_numbers` NumbersGetResponsesContentApplicationJsonSchemaResponsePhoneNumbersItems[]
      - `number` string — Phone number.
      - `sid` string, nullable — Phone number SID. May be null for custom numbers.
      - `is_available` boolean — Whether the number is available for inbound assignment.

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/synthflow/apis/platform-api.md) · [All operations](https://skmtc.dev/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synthflow/platform-api/revisions/6976456ad422/schema)