Add Phone Numbers to a Port Order Group

Upon submission of a Port Order Request, the Flowroute API will split the Phone Numbers specified by Losing Carrier. The result is a Port Order Group that contains 1 or more Port Orders.

As each Port Order represents a specific Carrier, you can only add additional numbers to a Port Order that are covered by that carrier.

At times it is necessary to add more phone numbers to a pending request. At this point, you have two options: you can choose to add the new numbers to a specific port order in the request, or you can choose to add them to the overall request or group.

When adding to the overall Group, the Flowroute API will match specified numbers to any of the existing Losing Carriers. If one is not found, it will create a new Port Order for that Carrier and Number and add that order to the Group.


POST /portorders/:group_id/numbers

Body Parameters

  • numbers

    A comma delimited list of numbers to add. Cannot be empty.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains a new copy of the porting request.

Example Request

						POST /v2/portorders/41351/numbers HTTP/1.1
Content-Type: application/json
Accept: application/json

"add": ["+1206555444", "+15465934334"],

Example Request

curl -X POST -u accessKey:secretKey -d '{"add": ["+12342235677", "+14536775443"]}' -H 'Content-Type':'application/json'


                        200 OK

  "data": {
    "attributes": {
      "alias": "Port Order 6/12/2018",
      "billing_address": {
        "city": "Seattle",
        "country": "US",
        "state": "WA",
        "street": "1218 3rd Ave",
        "street2": null,
        "zip": "98101"
      "billing_name": "John Doe",
      "billing_number": "",
      "business_documents": [
          "filename": "",
          "status": "uploaded"
          "filename": "",
          "status": "failed"
      "comments": [],
      "company": "Leather Inc.",
      "cost": "7.5",
      "desired_completion_date": "2018-07-12",
      "enable_cnam_lookups": true,
      "group_id": "38697",
      "last_4_ssn": "",
      "loa_details": {
        "cc": "",
        "email": ""
      "numbers": [
      "pin": "4321",
      "presets": {
        "cnam_id": null,
        "e911_id": null,
        "alias": null,
        "failover_route_id": null,
        "primary_route_id": null
      "provider": "Verizon",
      "provider_account": "123ABC",
      "status": "pending",
      "status_updated_at": null,
      "status_url": "",
      "usage_type": "residential"
    "id": "42361",
    "links": {
      "self": ""
    "type": "portorder"
  "links": {
    "self": ""