---
title: "Retrieve a list of all Phone Numbers in the Proxy Number Pool for a Service. A maximum of 100 records will be returned per page."
method: GET
path: "/v1/Services/{ServiceSid}/PhoneNumbers"
tags: ["ProxyV1PhoneNumber"]
---

# Retrieve a list of all Phone Numbers in the Proxy Number Pool for a Service. A maximum of 100 records will be returned per page.

`GET /v1/Services/{ServiceSid}/PhoneNumbers`

Retrieve a list of all Phone Numbers in the Proxy Number Pool for a Service. A maximum of 100 records will be returned per page.

## Path parameters

- `ServiceSid` string, required

## Query parameters

- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `phone_numbers` ProxyV1ServicePhoneNumber[]
    - `sid` string, nullable — The unique string that we created to identify the PhoneNumber resource.
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource.
    - `service_sid` string, nullable — The SID of the PhoneNumber resource's parent [Service](https://www.twilio.com/docs/proxy/api/service) resource.
    - `date_created` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created.
    - `date_updated` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated.
    - `phone_number` string, phone-number, nullable — The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
    - `friendly_name` string, nullable — The string that you assigned to describe the resource.
    - `iso_country` string, nullable — The ISO Country Code for the phone number.
    - `capabilities` object, nullable — The capabilities of the phone number.
      - `fax` boolean
      - `mms` boolean
      - `sms` boolean
      - `voice` boolean
    - `url` string, uri, nullable — The absolute URL of the PhoneNumber resource.
    - `is_reserved` boolean, nullable — Whether the phone number should be reserved and not be assigned to a participant using proxy pool logic. See [Reserved Phone Numbers](https://www.twilio.com/docs/proxy/reserved-phone-numbers) for more information.
    - `in_use` integer — The number of open session assigned to the number. See the [How many Phone Numbers do I need?](https://www.twilio.com/docs/proxy/phone-numbers-needed) guide for more information.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-02-20** (v1) `1469851deee4` — 1 breaking
  - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2024-08-26** (v1) `5d96b79babfd` — 1 info
  - the `in_use` response's property default value `0` was added for the status `200`
- **2023-08-10** (v1) `6b9a26829560` — 1 info
  - api tag `ProxyV1PhoneNumber` added
- **2023-02-02** (v1) `c4b95f6536e9` — 2 info
  - added the new optional `query` request parameter `Page`
  - added the new optional `query` request parameter `PageToken`
- **2023-01-13** (v1) `0f96912d65f8` — 2 breaking
  - the response property `meta/next_page_url` became nullable for the status `200`
  - the response property `meta/previous_page_url` became nullable for the status `200`

[Change history](https://skmtc.dev/twilio/apis/proxy-v1/changes/v1/Services/:ServiceSid/PhoneNumbers/get.md)

---

[API](https://skmtc.dev/twilio/apis/proxy-v1.md) · [All operations](https://skmtc.dev/twilio/apis/proxy-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/proxy-v1/revisions/a2e6d27b3ecd/schema)