VPS.org API

REST API Documentation

Plans API

Retrieve information about available VPS plans, pricing, and resource specifications.

Endpoints 2 endpoints
Base Path /api/v1/plans
GET /api/v1/plans/

List All Plans

Retrieve a list of all available VPS plans with pricing and resource specifications.

Query Parameters

Parameter Type Required Description
location string No Filter plans by datacenter location

Example Request

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/plans/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/plans/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/plans/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const plans = await response.json();
console.log(plans);
$ch = curl_init('https://admin.vps.org/api/v1/plans/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$plans = json_decode($response, true);
curl_close($ch);

Example Response

{
  "count": 4,
  "results": [
    {
      "id": 1,
      "name": "Starter VPS",
      "slug": "starter",
      "vcpus": 1,
      "memory": 2048,
      "storage": 40,
      "bandwidth": 1024,
      "price_monthly": 5.00,
      "price_hourly": 0.007,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central"],
      "description": "Perfect for small projects and testing"
    },
    {
      "id": 2,
      "name": "Standard VPS",
      "slug": "standard",
      "vcpus": 2,
      "memory": 4096,
      "storage": 80,
      "bandwidth": 2048,
      "price_monthly": 10.00,
      "price_hourly": 0.015,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
      "description": "Ideal for web applications and small databases"
    },
    {
      "id": 3,
      "name": "Performance VPS",
      "slug": "performance",
      "vcpus": 4,
      "memory": 8192,
      "storage": 160,
      "bandwidth": 4096,
      "price_monthly": 20.00,
      "price_hourly": 0.030,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
      "description": "High-performance for demanding applications"
    },
    {
      "id": 4,
      "name": "Enterprise VPS",
      "slug": "enterprise",
      "vcpus": 8,
      "memory": 16384,
      "storage": 320,
      "bandwidth": 8192,
      "price_monthly": 40.00,
      "price_hourly": 0.060,
      "available": true,
      "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
      "description": "Enterprise-grade resources for mission-critical workloads"
    }
  ]
}

Response Fields

Field Type Description
id integer Unique plan identifier
name string Human-readable plan name
slug string URL-friendly plan identifier
vcpus integer Number of virtual CPU cores
memory integer RAM in megabytes (MB)
storage integer Disk space in gigabytes (GB)
bandwidth integer Monthly data transfer in gigabytes (GB)
price_monthly decimal Monthly subscription price in USD
price_hourly decimal Hourly billing rate in USD
available boolean Whether plan is currently available for purchase
locations array List of datacenter locations where plan is available
description string Brief description of plan use case

Response Status Codes

200 Successfully retrieved plans list
401 Unauthorized - Invalid or missing authentication token
GET /api/v1/plans/{plan_id}/

Get Plan Details

Retrieve detailed information about a specific VPS plan.

Path Parameters

Parameter Type Required Description
plan_id integer Yes Unique plan ID

Example Request

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/plans/2/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

plan_id = 2
url = f"https://admin.vps.org/api/v1/plans/{plan_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const planId = 2;
const response = await fetch(`https://admin.vps.org/api/v1/plans/${planId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const plan = await response.json();
console.log(plan);

Example Response

{
  "id": 2,
  "name": "Standard VPS",
  "slug": "standard",
  "vcpus": 2,
  "memory": 4096,
  "storage": 80,
  "bandwidth": 2048,
  "price_monthly": 10.00,
  "price_hourly": 0.015,
  "available": true,
  "locations": ["us-west", "us-east", "eu-central", "asia-pacific"],
  "description": "Ideal for web applications and small databases",
  "features": [
    "SSD Storage",
    "99.9% Uptime SLA",
    "Free Backups",
    "24/7 Support",
    "DDoS Protection",
    "IPv6 Support"
  ],
  "recommended_for": [
    "WordPress sites with moderate traffic",
    "Small to medium web applications",
    "Development and testing environments",
    "Personal projects and portfolios"
  ]
}

Response Status Codes

200 Successfully retrieved plan details
401 Unauthorized - Invalid or missing authentication token
404 Not Found - Plan does not exist

Pricing Information

Billing Options

VPS.org offers two billing options to suit your needs:

Monthly Billing
  • Fixed monthly rate with no surprises with no surprises
  • Best for long-term, production workloads
  • Save up to 30% compared to hourly billing
  • Billed at the start of each month
  • No hidden fees or overage charges
Hourly Billing
  • Pay only for the hours you use
  • Perfect for testing and short-term projects
  • Billed in hourly increments
  • Maximum charge capped at monthly rate
  • Ideal for development environments

Included Features

All VPS plans include:

  • ✓ SSD Storage
  • ✓ 99.9% Uptime SLA
  • ✓ Free Daily Backups
  • ✓ 24/7 Customer Support
  • ✓ DDoS Protection
  • ✓ IPv6 Support
  • ✓ Full Root Access
  • ✓ Snapshots
  • ✓ Private Networking
  • ✓ API Access

Additional Resources

Need to add more resources? Additional services available:

Choosing the Right Plan

Quick Guide

Plan Best For Typical Use Cases
Starter VPS Personal projects, testing Static websites, learning environments, small blogs
Standard VPS Small businesses, web apps WordPress sites, small e-commerce, development servers
Performance VPS Medium traffic applications High-traffic WordPress, SaaS applications, databases
Enterprise VPS Large-scale applications Enterprise apps, large databases, video streaming
Need help choosing? Contact our sales team at at sales@vps.org for personalized recommendations based on your specific requirements.