Sub Resellers

Create and Manage Sub Resellers of your account

• GET/account/reseller

  Gets the details of all active sub resellers on the account

  Back to top

  Request Details

  Response Details

  Request Details

  This command has no URL/Query String parameters

  Response Details

  200 Response

  {
      "result" : [
          {
              "addresses" : [
                  {
                      "city" : "Exampleton",
                      "country_code" : "GB",
                      "created_on" : "2020-09-27",
                      "state" : "",
                      "street_one" : "1 Example Street",
                      "street_three" : "",
                      "street_two" : "",
                      "updated_on" : "2020-09-27",
                      "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
                      "zip" : "EX4M PL3"
                  }
              ],
              "allow_outbound" : true,
              "contact_name" : "Pete's Plumbing and Electrical",
              "created_on" : "2020-09-27",
              "ip_addresses" : [
                  {
                      "created_on" : "2020-09-27",
                      "ip_range" : "255.255.255.255/32"
                  }
              ],
              "name" : "Example Sub Reseller",
              "phone" : "+443301226000",
              "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7",
              "updated_on" : "2020-09-27",
              "users" : [
                  {
                      "contact_first_name" : "Pete",
                      "contact_last_name" : "Plumber",
                      "created_on" : "2020-09-27",
                      "email" : "pete@example.com",
                      "name" : "pete_the_plumber",
                      "password" : "password",
                      "role_id" : 1,
                      "updated_on" : "2020-09-27",
                      "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
                  }
              ],
              "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
          }
      ],
      "status_code" : 200,
      "status_message" : "OK"
  }

• GET/account/reseller/{uuid}

  Gets the details for a specific sub reseller on the account

  Back to top

  Request Details

  Response Details

  Request Details

  URL and Query String Parameters

  • Name

  • Type

  • Required

  • • uuid

    • String

    • True

    The UUID of the Sub Reseller to be queried

  Response Details

  200 Response

  {
      "result" : {
          "addresses" : [
              {
                  "city" : "Exampleton",
                  "country_code" : "GB",
                  "created_on" : "2020-09-27",
                  "state" : "",
                  "street_one" : "1 Example Street",
                  "street_three" : "",
                  "street_two" : "",
                  "updated_on" : "2020-09-27",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
                  "zip" : "EX4M PL3"
              }
          ],
          "allow_outbound" : true,
          "contact_name" : "Pete's Plumbing and Electrical",
          "created_on" : "2020-09-27",
          "ip_addresses" : [
              {
                  "created_on" : "2020-09-27",
                  "ip_range" : "255.255.255.255/32"
              }
          ],
          "name" : "Example Sub Reseller",
          "phone" : "+443301226000",
          "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7",
          "updated_on" : "2020-09-27",
          "users" : [
              {
                  "contact_first_name" : "Pete",
                  "contact_last_name" : "Plumber",
                  "created_on" : "2020-09-27",
                  "email" : "pete@example.com",
                  "name" : "pete_the_plumber",
                  "password" : "password",
                  "role_id" : 1,
                  "updated_on" : "2020-09-27",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
              }
          ],
          "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
      },
      "status_code" : 200,
      "status_message" : "OK"
  }

  404 Response

  {
      "result" : {},
      "status_code" : 404,
      "status_message" : "Not Found"
  }

• POST/account/reseller

  Creates a new sub reseller

  Back to top

  Request Details

  Response Details

  Request Details

  This command has no URL/Query String parameters

  POST body

  • Name

  • Type

  • Required

  • • addresses

    • Array of Reseller Address

    • False

    A list of this Reseller's Addresses

  • • contact_name

    • String

    • True

    The contact name for this Reseller

  • • name

    • String

    • True

    The name of this Reseller

  • • phone

    • String

    • False

    The phone number for this Reseller

  • • store_front

    • String

    • False

    The UUID of the Store this Reseller belongs to

  • • users

    • Array of Reseller User

    • False

    A list of this Reseller's Users.

  Allowed IP Range

  An Allowed IP Range is a range of IP Addresses in CIDR notation that has been white-listed for access to the API.

  • • ip_range

    • String

    • True

    The IP Address Range in CIDR notation

  Reseller User

  A Reseller User provides access credentials to use the API or Web Portal for a specific reseller

  • • contact_first_name

    • String

    • False

    This Reseller User's first name

  • • contact_last_name

    • String

    • False

    This Reseller User's last name

  • • email

    • String

    • True

    This Reseller User's email address

  • • name

    • String

    • True

    This Reseller User's username

  • • password

    • String

    • True

    This Reseller User's password

  • • role_id

    • int

    • True

    This Reseller User's role id, which determines their level of access.
    Valid roles are

    • 1 - API Admin
    • 3 - Storefront User

  Reseller Address

  A Reseller Address is a geographical address used for billing of a reseller

  • • city

    • String

    • True

    The town/city of the address

  • • country_code

    • String

    • True

    The Country ISO Code

  • • state

    • String

    • False

    The county/state of the street address

  • • street_one

    • String

    • True

    The first line of the street address

  • • street_three

    • String

    • False

    The third line of the street address

  • • street_two

    • String

    • False

    The second line of the street address

  • • zip

    • String

    • True

    The Zip/Post Code

  JSON all-fields example:

  {
      "addresses" : [
          {
              "city" : "Exampleton",
              "country_code" : "GB",
              "state" : "",
              "street_one" : "1 Example Street",
              "street_three" : "",
              "street_two" : "",
              "zip" : "EX4M PL3"
          }
      ],
      "contact_name" : "Pete's Plumbing and Electrical",
      "name" : "Example Sub Reseller",
      "phone" : "+443301226000",
      "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7",
      "users" : [
          {
              "contact_first_name" : "Pete",
              "contact_last_name" : "Plumber",
              "email" : "pete@example.com",
              "name" : "pete_the_plumber",
              "password" : "password",
              "role_id" : 1
          }
      ]
  }

  Response Details

  201 Response

  {
      "result" : {
          "addresses" : [
              {
                  "city" : "Exampleton",
                  "country_code" : "GB",
                  "created_on" : "2020-09-27",
                  "state" : "",
                  "street_one" : "1 Example Street",
                  "street_three" : "",
                  "street_two" : "",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
                  "zip" : "EX4M PL3"
              }
          ],
          "allow_outbound" : true,
          "contact_name" : "Pete's Plumbing and Electrical",
          "created_on" : "2020-09-27",
          "ip_addresses" : [
              {
                  "created_on" : "2020-09-27",
                  "ip_range" : "255.255.255.255/32"
              }
          ],
          "name" : "Example Sub Reseller",
          "phone" : "+443301226000",
          "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7",
          "users" : [
              {
                  "contact_first_name" : "Pete",
                  "contact_last_name" : "Plumber",
                  "created_on" : "2020-09-27",
                  "email" : "pete@example.com",
                  "name" : "pete_the_plumber",
                  "password" : "password",
                  "role_id" : 1,
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
              }
          ],
          "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
      },
      "status_code" : 201,
      "status_message" : "Created"
  }

  400 Response

  {
      "result" : {},
      "status_code" : 400,
      "status_message" : "Bad Request"
  }

  404 Response

  {
      "result" : {},
      "status_code" : 404,
      "status_message" : "Not Found"
  }

• PUT/account/reseller/{uuid}

  Updates a sub reseller

  Back to top

  Request Details

  Response Details

  Request Details

  URL and Query String Parameters

  • Name

  • Type

  • Required

  • • uuid

    • String

    • True

    The UUID of the Sub Reseller to be updated

  PUT body

  • Name

  • Type

  • Required

  • • addresses

    • Array of Reseller Address

    • False

    A list of this Reseller's Addresses

  • • contact_name

    • String

    • True

    The contact name for this Reseller

  • • name

    • String

    • True

    The name of this Reseller

  • • phone

    • String

    • False

    The phone number for this Reseller

  • • store_front

    • String

    • False

    The UUID of the Store this Reseller belongs to

  • • users

    • Array of Reseller User

    • False

    A list of this Reseller's Users.

  Allowed IP Range

  An Allowed IP Range is a range of IP Addresses in CIDR notation that has been white-listed for access to the API.

  • • ip_range

    • String

    • True

    The IP Address Range in CIDR notation

  Reseller User

  A Reseller User provides access credentials to use the API or Web Portal for a specific reseller

  • • contact_first_name

    • String

    • False

    This Reseller User's first name

  • • contact_last_name

    • String

    • False

    This Reseller User's last name

  • • email

    • String

    • True

    This Reseller User's email address

  • • name

    • String

    • True

    This Reseller User's username

  • • password

    • String

    • True

    This Reseller User's password

  • • role_id

    • int

    • True

    This Reseller User's role id, which determines their level of access.
    Valid roles are

    • 1 - API Admin
    • 3 - Storefront User

  Reseller Address

  A Reseller Address is a geographical address used for billing of a reseller

  • • city

    • String

    • True

    The town/city of the address

  • • country_code

    • String

    • True

    The Country ISO Code

  • • state

    • String

    • False

    The county/state of the street address

  • • street_one

    • String

    • True

    The first line of the street address

  • • street_three

    • String

    • False

    The third line of the street address

  • • street_two

    • String

    • False

    The second line of the street address

  • • zip

    • String

    • True

    The Zip/Post Code

  JSON all-fields example:

  {
      "contact_name" : "Pete's Plumbing and Electrical",
      "name" : "Example Sub Reseller",
      "phone" : "+443301226000",
      "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7"
  }

  Response Details

  200 Response

  {
      "result" : {
          "addresses" : [
              {
                  "city" : "Exampleton",
                  "country_code" : "GB",
                  "created_on" : "2020-09-27",
                  "state" : "",
                  "street_one" : "1 Example Street",
                  "street_three" : "",
                  "street_two" : "",
                  "updated_on" : "2020-09-27",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
                  "zip" : "EX4M PL3"
              }
          ],
          "allow_outbound" : true,
          "contact_name" : "Pete's Plumbing and Electrical",
          "created_on" : "2020-09-27",
          "ip_addresses" : [
              {
                  "created_on" : "2020-09-27",
                  "ip_range" : "255.255.255.255/32"
              }
          ],
          "name" : "Example Sub Reseller",
          "phone" : "+443301226000",
          "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7",
          "updated_on" : "2020-09-27",
          "users" : [
              {
                  "contact_first_name" : "Pete",
                  "contact_last_name" : "Plumber",
                  "created_on" : "2020-09-27",
                  "email" : "pete@example.com",
                  "name" : "pete_the_plumber",
                  "password" : "password",
                  "role_id" : 1,
                  "updated_on" : "2020-09-27",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
              }
          ],
          "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
      },
      "status_code" : 200,
      "status_message" : "OK"
  }

  400 Response

  {
      "result" : {},
      "status_code" : 400,
      "status_message" : "Bad Request"
  }

  404 Response

  {
      "result" : {},
      "status_code" : 404,
      "status_message" : "Not Found"
  }

  409 Response

  {
      "result" : {},
      "status_code" : 409,
      "status_message" : "Conflict"
  }

• PUT/account/reseller/{uuid}/international-calls-allowed

  Updates whether a sub reseller can make international calls

  Back to top

  Request Details

  Response Details

  Request Details

  URL and Query String Parameters

  • Name

  • Type

  • Required

  • • uuid

    • String

    • True

    The UUID of the Sub Reseller to be updated

  PUT body

  • Name

  • Type

  • Required

  • • addresses

    • Array of Reseller Address

    • False

    A list of this Reseller's Addresses

  • • contact_name

    • String

    • True

    The contact name for this Reseller

  • • name

    • String

    • True

    The name of this Reseller

  • • phone

    • String

    • False

    The phone number for this Reseller

  • • store_front

    • String

    • False

    The UUID of the Store this Reseller belongs to

  • • users

    • Array of Reseller User

    • False

    A list of this Reseller's Users.

  Allowed IP Range

  An Allowed IP Range is a range of IP Addresses in CIDR notation that has been white-listed for access to the API.

  • • ip_range

    • String

    • True

    The IP Address Range in CIDR notation

  Reseller User

  A Reseller User provides access credentials to use the API or Web Portal for a specific reseller

  • • contact_first_name

    • String

    • False

    This Reseller User's first name

  • • contact_last_name

    • String

    • False

    This Reseller User's last name

  • • email

    • String

    • True

    This Reseller User's email address

  • • name

    • String

    • True

    This Reseller User's username

  • • password

    • String

    • True

    This Reseller User's password

  • • role_id

    • int

    • True

    This Reseller User's role id, which determines their level of access.
    Valid roles are

    • 1 - API Admin
    • 3 - Storefront User

  Reseller Address

  A Reseller Address is a geographical address used for billing of a reseller

  • • city

    • String

    • True

    The town/city of the address

  • • country_code

    • String

    • True

    The Country ISO Code

  • • state

    • String

    • False

    The county/state of the street address

  • • street_one

    • String

    • True

    The first line of the street address

  • • street_three

    • String

    • False

    The third line of the street address

  • • street_two

    • String

    • False

    The second line of the street address

  • • zip

    • String

    • True

    The Zip/Post Code

  JSON all-fields example:

  {
      "contact_name" : "Pete's Plumbing and Electrical",
      "name" : "Example Sub Reseller",
      "phone" : "+443301226000",
      "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7"
  }

  Response Details

  200 Response

  {
      "result" : {
          "addresses" : [
              {
                  "city" : "Exampleton",
                  "country_code" : "GB",
                  "created_on" : "2020-09-27",
                  "state" : "",
                  "street_one" : "1 Example Street",
                  "street_three" : "",
                  "street_two" : "",
                  "updated_on" : "2020-09-27",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6",
                  "zip" : "EX4M PL3"
              }
          ],
          "allow_outbound" : true,
          "contact_name" : "Pete's Plumbing and Electrical",
          "created_on" : "2020-09-27",
          "ip_addresses" : [
              {
                  "created_on" : "2020-09-27",
                  "ip_range" : "255.255.255.255/32"
              }
          ],
          "name" : "Example Sub Reseller",
          "phone" : "+443301226000",
          "store_front" : "31347d42-00bd-44a5-9b5c-20dc4197a2f7",
          "updated_on" : "2020-09-27",
          "users" : [
              {
                  "contact_first_name" : "Pete",
                  "contact_last_name" : "Plumber",
                  "created_on" : "2020-09-27",
                  "email" : "pete@example.com",
                  "name" : "pete_the_plumber",
                  "password" : "password",
                  "role_id" : 1,
                  "updated_on" : "2020-09-27",
                  "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
              }
          ],
          "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
      },
      "status_code" : 200,
      "status_message" : "OK"
  }

  400 Response

  {
      "result" : {},
      "status_code" : 400,
      "status_message" : "Bad Request"
  }

  404 Response

  {
      "result" : {},
      "status_code" : 404,
      "status_message" : "Not Found"
  }

  409 Response

  {
      "result" : {},
      "status_code" : 409,
      "status_message" : "Conflict"
  }

• DELETE/account/reseller/{uuid}

  Deletes the specified sub reseller

  Back to top

  Request Details

  Response Details

  Request Details

  This command has no URL/Query String parameters

  Response Details

  204 Response

  {
      "result" : {},
      "status_code" : 204,
      "status_message" : "No Content"
  }

  400 Response

  {
      "result" : {},
      "status_code" : 400,
      "status_message" : "Bad Request"
  }

  404 Response

  {
      "result" : {},
      "status_code" : 404,
      "status_message" : "Not Found"
  }