Purchase a Phone Number

Use this endpoint to purchase a phone number from available Flowroute inventory.

Endpoint

POST /numbers/:id

Request Parameters

  • id
    integer required

    Phone number to purchase. The number must be in 11-digit North American format; e.g. 12061231234.

Example Request

GET /v2.1/numbers/12011231234 HTTP/1.1
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

		

Example Request

curl -X POST https://api.flowroute.com/v2.1/numbers/12011231234 -u accessKey:secretKey

		

Example Response

201 CREATED

{
  {
  "data": {
    "included": [
      {
        "attributes": {
          "route_type": "sip-reg",
          "alias": "sip-reg",
          "value": null,
          "edge_strategy_id": null
        },
        "type": "route",
        "id": "0",
        "links": {
          "self": "https://api.staging.fl.gg/v2/routes/0"
        }
      }
    ],
    "data": {
      "relationships": {
        "cnam_preset": {
          "data": null
        },
        "e911_address": {
          "data": null
        },
        "failover_route": {
          "data": null
        },
        "primary_route": {
          "data": {
            "type": "route",
            "id": "0"
          }
        }
      },
      "attributes": {
        "status": "PURCHASED",
        "note": null,
        "rate_center": "oradell",
        "monthly_cost": 1.25,
        "rate_type": "local",
        "value": "12012673307",
        "iso_country": "US",
        "inbound_rate": 0.012,
        "alias": null,
        "state": "nj",
        "messaging_enabled": false,
        "number_type": "longcode",
        "setup_cost": 1.0,
        "tier": "Standard",
        "cnam_lookups_enabled": true
      },
      "type": "number",
      "id": "12012673307",
      "links": {
        "self": "https://api.staging.fl.gg/v2/numbers/12012673307"
      }
    },
    "links": {
      "self": "https://api.staging.fl.gg/v2/numbers/12012673307"
    }
  }
}
}