Downgrade Service

curl --request POST \
  --url https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "new_plan": "standard-vps"
}
'

import requests

url = "https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade"

payload = { "new_plan": "standard-vps" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({new_plan: 'standard-vps'})
};

fetch('https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'new_plan' => 'standard-vps'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade"

	payload := strings.NewReader("{\n  \"new_plan\": \"standard-vps\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"new_plan\": \"standard-vps\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"new_plan\": \"standard-vps\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "request_id": "REQ-002387",
    "type": "downgrade",
    "request_status": "accepted",
    "service_number": 971100002,
    "current_plan": "Professional VPS",
    "requested_plan": "Standard VPS",
    "submitted_date": "2026-06-21T15:10:00.000Z"
  }
}

POST

services

{service_number}

downgrade

Downgrade Service

curl --request POST \
  --url https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "new_plan": "standard-vps"
}
'

import requests

url = "https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade"

payload = { "new_plan": "standard-vps" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({new_plan: 'standard-vps'})
};

fetch('https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'new_plan' => 'standard-vps'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade"

	payload := strings.NewReader("{\n  \"new_plan\": \"standard-vps\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"new_plan\": \"standard-vps\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://brokers.newyorkcityservers.com/api/v1/services/{service_number}/downgrade")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"new_plan\": \"standard-vps\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "request_id": "REQ-002387",
    "type": "downgrade",
    "request_status": "accepted",
    "service_number": 971100002,
    "current_plan": "Professional VPS",
    "requested_plan": "Standard VPS",
    "submitted_date": "2026-06-21T15:10:00.000Z"
  }
}

Submit a downgrade from the current service plan to a lower plan.

A successful response means that the API accepted the request. It does not mean that the plan change is complete.

Allowed Plan Changes

A downgrade must move from a higher plan to a lower plan in this order:

Dedicated Server
Professional VPS
Standard VPS
Basic VPS

Current plan	Allowed target plans
`Dedicated Server`	`Professional VPS`, `Standard VPS`, or `Basic VPS`
`Professional VPS`	`Standard VPS` or `Basic VPS`
`Standard VPS`	`Basic VPS`
`Basic VPS`	None

The endpoint rejects a request for the current plan. It also rejects a move to a higher plan. Use the Upgrade Service endpoint for a move to a higher plan.

Accepted Response

The endpoint returns HTTP 200 after it queues the work. The response does not contain an internal request UUID, an action ID, or a completion time.

Downgrade Processing

A reboot of the client’s service is required for finalizing the downgrade. Therefore, once a downgrade request is submitted the client will receive an email containing the next required steps to complete the downgrade process. The downgrade to the client’s service is not applied until they perform the required steps.

Errors

All error responses have success: false and an error object.

HTTP status	Code	Cause
`400`	`invalid_parameter`	The service number is not valid, or `new_plan` is not an accepted plan.
`400`	`invalid_request`	The request body is not valid JSON.
`400`	`missing_parameter`	`new_plan` is missing, empty, or not a string.
`400`	`invalid_state`	The target is the current plan, the target is not a downgrade, or the current plan is not recognized.
`400`	`invalid_state`	The service is cancelled or terminated. The response includes `details.current_status`.
`400`	`service_pending_provisioning`	The service status is `pending`.
`401`	`authentication_failed`	The API key is missing, invalid, or expired.
`403`	`insufficient_permissions`	The key lacks `admin:full`, or the request IP is not allowed.
`404`	`not_found`	The service does not exist in the broker account or access is denied.
`429`	`rate_limit_exceeded`	The API key reached its rate limit. Use the `Retry-After` response header.
`500`	`server_error`	Broker Panel could not create or queue the downgrade request, or an unexpected error occurred.

Authorizations

Authorization

string

header

required

Send the API key in the Authorization bearer header. Production keys begin with sk_live_.

Path Parameters

service_number

integer<int64>

required

Public service number parsed as a base-10 integer.

Body

application/json

new_plan

string

required

Target plan slug or label, accepted case-insensitively. Valid slugs are basic-vps, standard-vps, professional-vps, and dedicated-server.

Response

Downgrade accepted for processing.

success

boolean

required

data

object

required

Show child attributes

message

string

pagination

object

Show child attributes

Last modified on August 2, 2026

Getting Started

Services

Requests

Reports

Downgrade Service

Allowed Plan Changes

Accepted Response

Downgrade Processing

Errors

Authorizations

Path Parameters

Body

Response

​Allowed Plan Changes

​Accepted Response

​Downgrade Processing

​Errors

Authorizations

Path Parameters

Body

Response

Allowed Plan Changes

Accepted Response

Downgrade Processing

Errors