---
title: "List all Incoming Phone Numbers"
method: GET
path: "/Accounts/{AccountSid}/IncomingPhoneNumbers"
tags: ["Incoming Phone Numbers"]
---

# List all Incoming Phone Numbers

`GET /Accounts/{AccountSid}/IncomingPhoneNumbers`

List all incoming phone numbers.

#### Permissions
The API token must include the following scopes: _Numbers_.

## Path parameters

- `AccountSid` string, uuid, required

## Query parameters

- `PhoneNumber` string
- `FriendlyName` string
- `Beta` boolean
- `Origin` string

## Response `200`

The request has succeeded.

- IncomingPhoneNumberListResponse — Response containing a list of incoming phone numbers.
  - `uri` string — The URI of the current page.
  - `first_page_uri` string — The URI of the first page.
  - `next_page_uri` string — The URI of the next page.
  - `previous_page_uri` string, nullable — The URI of the previous page.
  - `page` integer — The current page number.
  - `page_size` integer — The number of items per page.
  - `account_sid` string — The unique identifier for this account.
  - `incoming_phone_numbers` IncomingPhoneNumber[] — List of incoming phone numbers.
    - `account_sid` string, uuid — The unique identifier for the account that is associated with this phone number.
    - `address_requirements` 'none' | 'any' | 'local' | 'foreign' — Address requirements.
    - `address_sid` string — The unique identifier for the address associated with this phone number.
    - `api_version` string — The version of the SignalWire API.
    - `beta` boolean — New numbers on SignalWire are marked as beta.
    - `capabilities` IncomingPhoneNumberCapabilities — Phone number capabilities.
      - `Voice` boolean — Whether or not voice is enabled.
      - `SMS` boolean — Whether or not SMS is enabled.
      - `MMS` boolean — Whether or not MMS is enabled.
      - `Fax` boolean — Whether or not fax is enabled.
    - `date_created` string — The date, in RFC 2822 format, this phone number was created.
    - `date_updated` string — The date, in RFC 2822 format, this phone number was updated.
    - `emergency_address_sid` string, nullable — The unique identifier of the address associated with E911 for this phone number.
    - `emergency_status` 'active' | 'inactive' — Emergency status.
    - `friendly_name` string — A formatted version of the number.
    - `identity_sid` string — The unique identifier for the identity associated with this phone number.
    - `origin` 'signalwire' | 'hosted' — Phone number origin.
    - `phone_number` string — The incoming number in E.164 format.
    - `sid` string — The unique identifier for this phone number.
    - `sms_application_sid` string, nullable — The unique identifier for the application associated with SMS handling on this phone number.
    - `sms_fallback_method` string — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
    - `sms_fallback_url` string, nullable — The URL to request if errors occur when fetching SmsUrl.
    - `sms_method` string — Whether the request to SmsUrl is a `GET` or a `POST`. Default is `POST`.
    - `sms_url` string, nullable — The URL to request when an incoming SMS is received.
    - `status_callback` string — The URL to request to pass status updates to.
    - `status_callback_method` string — Whether the request to StatusCallback is a `GET` or a `POST`. Default is `POST`.
    - `trunk_sid` string — The unique identifier for the Trunk associated with this phone number.
    - `uri` string — The URI for this number.
    - `voice_application_sid` string, nullable — The unique identifier for the application associated with call handling on this phone number.
    - `voice_caller_id_lookup` boolean — Whether or not to look up a caller's name in the database.
    - `voice_fallback_method` string — Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. Default is `POST`.
    - `voice_fallback_url` string — The URL to request if errors occur when fetching `Url`.
    - `voice_method` string — Whether the request to Url is a `GET` or a `POST`. Default is `POST`.
    - `voice_url` string — The URL to request when an incoming call is received.

## Other responses

- `401` — 401 Unauthorized response.

## Changes

- **2026-01-15** `686ef84c2abc` — 6 breaking
  - the response property `incoming_phone_numbers/items/emergency_address_sid` became nullable for the status `200`
  - the response property `incoming_phone_numbers/items/sms_application_sid` became nullable for the status `200`
  - the response property `incoming_phone_numbers/items/sms_fallback_url` became nullable for the status `200`
  - the response property `incoming_phone_numbers/items/sms_url` became nullable for the status `200`
  - …2 more
- **2026-01-15** `3c88f14db21e` — 3 breaking, 10 info
  - removed the enum value `hosted` from the `query` request parameter `Origin`
  - removed the enum value `signalwire` from the `query` request parameter `Origin`
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/pagination, subschema #1` from the response body `allOf` list for the response status `200`
  - …9 more

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/IncomingPhoneNumbers/get.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/686ef84c2abc/schema)