# List incoming phone number toll free

**GET /2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/TollFree.json**


Incoming toll free phone numbers on a Twilio account/project

## Servers
- https://api.twilio.com: https://api.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **AccountSid** (string)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resources to read.

### Query parameters
- **Beta** (boolean)
  Whether to include phone numbers new to the Twilio platform. Can be: `true` or `false` and the default is `true`.
- **FriendlyName** (string)
  A string that identifies the resources to read.
- **PhoneNumber** (string(phone-number))
  The phone numbers of the IncomingPhoneNumber resources to read. You can specify partial numbers and use '*' as a wildcard for any digit.
- **Origin** (string)
  Whether to include phone numbers based on their origin. Can be: `twilio` or `hosted`. By default, phone numbers of all origin are included.
- **PageSize** (integer(int64))
  How many resources to return in each list page. The default is 50, and the maximum is 1000.
- **Page** (integer)
  The page index. This value is simply for client state.
- **PageToken** (string)
  The page token. This is provided by the API.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **incoming_phone_numbers** (array[object])

- **end** (integer)

- **first_page_uri** (string(uri))

- **next_page_uri** (string(uri) | null)

- **page** (integer)

- **page_size** (integer)

- **previous_page_uri** (string(uri) | null)

- **start** (integer)

- **uri** (string(uri))



[Powered by Bump.sh](https://bump.sh)