List phone numbers
Lists the phone numbers owned by your SignalWire project. These numbers can send or receive communications according to their capabilities and assigned handlers. Use [Search phone numbers](/docs/apis/rest/phone-numbers/search-available-phone-numbers) for numbers available to purchase, or Compatibility [Incoming Phone Numbers](/docs/compatibility-api/rest/incoming-phone-numbers/list-incoming-phone-numbers) for SID-based routes. Results are sorted by creation date, most recent first.
#### Permissions
The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.
[Learn more about API scopes](/docs/platform/your-signalwire-api-space).
Authentication
AuthorizationBasic
SignalWire Basic Authentication using Project ID and API Token.
The client sends HTTP requests with the Authorization header containing
the word Basic followed by a space and a base64-encoded string of project_id:token.
The project ID will be used as the username and the API token as the password.
Example:
```
Authorization: Basic base64(project_id:token)
```
Query parameters
filter_name
The name given to the phone number. Will return all Phone Numbers containing this value as a substring.
filter_number
The phone number in E164 format. Will return all Phone Numbers containing this value as a substring.
page_number
The page number to retrieve (0-indexed).
page_size
The number of items per page (1-1000).
page_token
Token for cursor-based pagination. Required when page_number > 0.
Response
The request has succeeded.
links
Pagination links.
data
List of phone numbers.
Errors
400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error