List Available Phone Numbers by Exchanges

This endpoint returns a list of all Central Office (exchange) codes containing purchasable phone numbers. All request parameters are optional. If you don't specify a limit, results are limited to the first 10 items.

This endpoint returns a list of all Central Office (exchange) codes (NXXs), which are area codes with purchasable phone numbers.

Endpoint

GET /available/exchanges

Request Parameters

  • limit
    integer

    Limits the number of exchange codes to retrieve. A maximum of 400 items can be retrieved.

  • offset
    integer

    Offsets the list of exchange codes to retrieve by your specified value.

  • max_setup_cost
    float

    Restricts the results to the specified maximum non-recurring setup cost. For more details around pricing, please see Volume prcing for your Cloud Communications Needs.

  • areacode
    integer

    Restricts the results to the specified area code.

Example Request

GET /v2.1/numbers/available/exchanges?limit=2 HTTP/1.1
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

                        

Example Request

curl https://api.flowroute.com/v2.1/numbers/available/exchanges?limit=2 -u accessKey:secretKey

                        

Example Response

200 OK

                                       
{
  "data": [
    {
      "id": "201267",
      "links": {
        "related": "https://api.flowroute.com/v2/numbers/available?starts_with=1201267"
      },
      "type": "exchange"
    },
    {
      "id": "201616",
      "links": {
        "related": "https://api.flowroute.com/v2/numbers/available?starts_with=1201616"
      },
      "type": "exchange"
    }
  ],
  "links": {
    "next": "https://api.flowroute.com/v2/numbers/available/exchanges?limit=2&offset=2",
    "self": "https://api.flowroute.com/v2/numbers/available/exchanges?limit=2&offset=0"
  }
}