List Available Tiers

Returns a list of Tiers containing purchasable phone numbers. All request parameters are optional.

Endpoint

GET /available/tiers

Query Parameters

  • limit
    integer

    Limits the number of exchange codes to retrieve. A maximum of 200 items can be retrieved with 10 being the default value if not specified.

  • offset
    integer

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

Response Fields

On success, the HTTP status code in the response header is 200 OK and the response body contains an array of exchange objects in JSON format. On error, the header status code is an error code and the response body contains an array of error objects.

  • data
    array

    An array of tier objects that satisfy your query individually composed of:

    • id
      string

      Unique identifier of the tier.

    • links
      object

      Links object pointing to the related array of phone numbers that are associated with the Tier.

    • type
      string

      This will always be exchange.

  • links
    object

    Links object pointing to your search and a link to the next page if any. For example, https://api.flowroute.com/v2/numbers/available/tiers?limit=2&offset=0.

Example Request

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

                        

Example Request

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

                        

Example Responses

200 OK

{
  {
    "data": [
      {
        "id": "US Off-Net Selective",
        "links": {
          "related": "https://api.flowroute.com/v2/numbers?tier=Standard"
        },
        "type": "tier"
      },
      {
        "id": "US On-Net HyperNetwork Capable",
        "links": {
          "related": "https://api.flowroute.com/v2/numbers?tier=Toll-free"
        },
        "type": "tier"
      }
    ],
    "links": {
      "next": "https://api.flowroute.com/v2/numbers/tiers?limit=2&offset=2",
      "self": "https://api.flowroute.com/v2/numbers/tiers?limit=2&offset=0"
    }
  }