# List available phone number national

**GET /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{CountryCode}/National.json**


Available national phone numbers

## 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) requesting the AvailablePhoneNumber resources.
- **CountryCode** (string(iso-country-code))
  The [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the country from which to read phone numbers.

### Query parameters
- **AreaCode** (integer)
  The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
- **Contains** (string)
  The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
- **SmsEnabled** (boolean)
  Whether the phone numbers can receive text messages. Can be: `true` or `false`.
- **MmsEnabled** (boolean)
  Whether the phone numbers can receive MMS messages. Can be: `true` or `false`.
- **VoiceEnabled** (boolean)
  Whether the phone numbers can receive calls. Can be: `true` or `false`.
- **ExcludeAllAddressRequired** (boolean)
  Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
- **ExcludeLocalAddressRequired** (boolean)
  Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
- **ExcludeForeignAddressRequired** (boolean)
  Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
- **Beta** (boolean)
  Whether to read phone numbers that are new to the Twilio platform. Can be: `true` or `false` and the default is `true`.
- **NearNumber** (string(phone-number))
  Given a phone number, find a geographically close number within `distance` miles. Distance defaults to 25 miles. Applies to only phone numbers in the US and Canada.
- **NearLatLong** (string)
  Given a latitude/longitude pair `lat,long` find geographically close numbers within `distance` miles. Applies to only phone numbers in the US and Canada.
- **Distance** (integer)
  The search radius, in miles, for a `near_` query.  Can be up to `500` and the default is `25`. Applies to only phone numbers in the US and Canada.
- **InPostalCode** (string)
  Limit results to a particular postal code. Given a phone number, search within the same postal code as that number. Applies to only phone numbers in the US and Canada.
- **InRegion** (string)
  Limit results to a particular region, state, or province. Given a phone number, search within the same region as that number. Applies to only phone numbers in the US and Canada.
- **InRateCenter** (string)
  Limit results to a specific rate center, or given a phone number search within the same rate center as that number. Requires `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
- **InLata** (string)
  Limit results to a specific local access and transport area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
- **InLocality** (string)
  Limit results to a particular locality or city. Given a phone number, search within the same Locality as that number.
- **FaxEnabled** (boolean)
  Whether the phone numbers can receive faxes. Can be: `true` or `false`.
- **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)
- **available_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)