List Available Area Codes

This endpoint returns a list of all Numbering Plan Area (NPA) 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.

Endpoint

GET /available/areacodes

Request Parameters

  • limit
    integer

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

  • offset
    integer

    Offsets the list of area 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.

Example Request

GET /v2.1/numbers/available/areacodes?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/areacodes?limit=2 -u accessKey:secretKey

Example Response

200 OK

                                       
{
  "data": [
    {
      "id": "201",
      "links": {
        "related": "https://api.flowroute.com/v2.1/numbers/available/exchanges?areacode=201"
      },
      "type": "areacode"
    },
    {
      "id": "202",
      "links": {
        "related": "https://api.flowroute.com/v2.1/numbers/available/exchanges?areacode=202"
      },
      "type": "areacode"
    }
  ],
  "links": {
    "next": "https://api.flowroute.com/v2.1/numbers/available/areacodes?limit=2&offset=2",
    "self": "https://api.flowroute.com/v2.1/numbers/available/areacodes?limit=2&offset=0"
  }
}