VPS.org API

REST API Documentation

API yeNzvimbo

Retrieve information about available datacenter locations for VPS deployment.

Magumo 1 endpoint
Nzira Yekutanga /api/v1/locations
Tora /api/v1/locations/

Nyora Nzvimbo Dzose

Retrieve a list of all available datacenter locations where you can deploy VPS servers.

Maparamita emibvunzo

Parameter Rudzi Zvinodiwa Kutaura
region string Hapana Filter by region: north-america, europe, asia, oceania
available boolean Hapana Show only locations currently accepting new servers

Muenzaniso weChikumbiro

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

url = "https://admin.vps.org/api/v1/locations/"
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/locations/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

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

Muenzaniso weMhinduro

{
  "count": 8,
  "results": [
    {
      "id": 1,
      "name": "New York",
      "slug": "ny-usa",
      "country": "United States",
      "country_code": "US",
      "city": "New York",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "network_provider": "Digital Realty",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to US East Coast"
      ],
      "average_latency_ms": {
        "us-east": 2,
        "us-west": 75,
        "europe": 85,
        "asia": 220
      }
    },
    {
      "id": 2,
      "name": "San Francisco",
      "slug": "sf-usa",
      "country": "United States",
      "country_code": "US",
      "city": "San Francisco",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 37.7749,
      "longitude": -122.4194,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to US West Coast & Asia"
      ],
      "average_latency_ms": {
        "us-east": 75,
        "us-west": 2,
        "europe": 150,
        "asia": 120
      }
    },
    {
      "id": 3,
      "name": "London",
      "slug": "lon-uk",
      "country": "United Kingdom",
      "country_code": "GB",
      "city": "London",
      "region": "europe",
      "continent": "Europe",
      "available": true,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "network_provider": "Telehouse",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "GDPR Compliant",
        "Low Latency to Europe"
      ],
      "average_latency_ms": {
        "us-east": 85,
        "us-west": 150,
        "europe": 5,
        "asia": 180
      }
    },
    {
      "id": 4,
      "name": "Frankfurt",
      "slug": "fra-de",
      "country": "Germany",
      "country_code": "DE",
      "city": "Frankfurt",
      "region": "europe",
      "continent": "Europe",
      "available": true,
      "latitude": 50.1109,
      "longitude": 8.6821,
      "network_provider": "Interxion",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "GDPR Compliant",
        "Central European Location"
      ],
      "average_latency_ms": {
        "us-east": 95,
        "us-west": 160,
        "europe": 3,
        "asia": 200
      }
    },
    {
      "id": 5,
      "name": "Singapore",
      "slug": "sgp-sg",
      "country": "Singapore",
      "country_code": "SG",
      "city": "Singapore",
      "region": "asia",
      "continent": "Asia",
      "available": true,
      "latitude": 1.3521,
      "longitude": 103.8198,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to Asia Pacific"
      ],
      "average_latency_ms": {
        "us-east": 250,
        "us-west": 180,
        "europe": 170,
        "asia": 5
      }
    },
    {
      "id": 6,
      "name": "Tokyo",
      "slug": "tok-jp",
      "country": "Japan",
      "country_code": "JP",
      "city": "Tokyo",
      "region": "asia",
      "continent": "Asia",
      "available": true,
      "latitude": 35.6762,
      "longitude": 139.6503,
      "network_provider": "Equinix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to East Asia"
      ],
      "average_latency_ms": {
        "us-east": 180,
        "us-west": 120,
        "europe": 240,
        "asia": 8
      }
    },
    {
      "id": 7,
      "name": "Sydney",
      "slug": "syd-au",
      "country": "Australia",
      "country_code": "AU",
      "city": "Sydney",
      "region": "oceania",
      "continent": "Oceania",
      "available": true,
      "latitude": -33.8688,
      "longitude": 151.2093,
      "network_provider": "NextDC",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Low Latency to Australia & New Zealand"
      ],
      "average_latency_ms": {
        "us-east": 210,
        "us-west": 140,
        "europe": 280,
        "asia": 120
      }
    },
    {
      "id": 8,
      "name": "Toronto",
      "slug": "tor-ca",
      "country": "Canada",
      "country_code": "CA",
      "city": "Toronto",
      "region": "north-america",
      "continent": "North America",
      "available": true,
      "latitude": 43.6532,
      "longitude": -79.3832,
      "network_provider": "Cologix",
      "features": [
        "100% Uptime SLA",
        "DDoS Protection",
        "IPv6 Support",
        "Private Networking",
        "Data Sovereignty (Canada)"
      ],
      "average_latency_ms": {
        "us-east": 20,
        "us-west": 65,
        "europe": 90,
        "asia": 210
      }
    }
  ]
}

Minda Yemhinduro

_Firi Rudzi Kutaura
id integer Unique location identifier
name string Human-readable location name
slug string URL-friendly location identifier
country string Country name
country_code string ISO 3166-1 alpha-2 country code
city string City name
region string Geographic region (north-america, europe, asia, oceania)
continent string Continent name
available boolean Whether location is accepting new servers
latitude decimal Geographic latitude
longitude decimal Geographic longitude
network_provider string Datacenter/network provider name
features array List of location-specific features
average_latency_ms object Average latency in milliseconds to major regions

Makodhi eMamiriro eMhinduro

200 Ndakabudirira kuwana runyorwa rwenzvimbo
401 Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo

Choosing the Right Location

Ne Target Audience

Target Audience Recommended Locations Why
US East Coast Users New York, Toronto Lowest latency (2-20ms), close proximity
US West Coast Users San Francisco Lowest latency (2ms), silicon valley connectivity
European Users London, Frankfurt GDPR compliant, low latency (3-5ms) across Europe
Asian Users Singapore, Tokyo Best connectivity to Asia Pacific region (5-8ms)
Australian/NZ Users Sydney Only Oceania location, lowest latency to Australia
Global Audience Multiple locations with load balancing Deploy in 2-3 regions for global coverage

Nezve Compliance Zvinodiwa

Kushanda kwe Network

Lowest Latency kune Main Markets
  • North America: New York (2ms to US East), San Francisco (2ms to US West)
  • Europe: Frankfurt (3ms), London (5ms)
  • Asia: Singapore (5ms), Tokyo (8ms)
  • Oceania: Sydney (asina sarudzo)
Best for Global Kugoverwa
  1. Primary: New York kana San Francisco (yakakura kwazvo vashandisi base)
  2. Chikoro: London kana Frankfurt (Europe kusanganisira)
  3. Tertiary: Singapore kana Tokyo (Asia kusanganisira)
Pro Tip: Yebasa-critical maapplication, kuisa kune akawanda nzvimbo neazvino failover yekuwedzera uptime uye geographic redundancy.

Data Center Infrastructure

Standard Features (All Locations)

  • ✓ Tier III kana kupfuura datacenters
  • ✓ 100% uptime SLA
  • ✓ Kuwanda kwemagetsi (N + 1 kana 2N)
  • ✓ Kuwedzera kupisa
  • ✓ 24/7 chengetedzo yemunhu
  • ✓ Biometric kuwanikwa kwezvidzora
  • ✓ DDoS kudzivirirwa (kusvika 10 Tbps kuderedza)
  • ✓ IPv4 uye IPv6 rutsigiro
  • ✓ Private networking (VLAN)
  • ✓ 10 Gbps + network backbone
  • ✓ Multiple upstream vanopa
  • ✓ BGP peering nemakambani makuru e network

Vagadziri veNetwork

_Panzvimbo: Mugadziri _Kukanganisa Nhoroondo
New York Digital Realty Tier III Major internet exchange point
San Francisco Equinix Tier III Silicon Valley connectivity hub
London Telehouse Tier III LINX (London Internet Exchange)
Frankfurt Interxion Tier III DE-CIX (world's largest IXP)
Singapore Equinix Tier III Asia Pacific connectivity hub
Tokyo Equinix Tier III JPIX and JPNAP peering
Sydney NextDC Tier III Oceania's largest datacenter
Toronto Cologix Tier III Canadian data sovereignty

Location Migration & Multi-Region Deployment

Kufamba pakati penzvimbo

Iwe unogona kushandura yako VPS kune imwe nzvimbo nekushandisa snapshots:

  1. Kugadzira snapshot yeyako yazvino VPS
  2. Create a new VPS in the target location
  3. Kudzoreredza snapshot kune nyowani VPS
  4. Kugadzirisa DNS zvinyorwa kuti zvionekwe kune nyowani IP
  5. Delete old VPS mushure mekuongororwa kwekupinda
Nzira: Kufamba kune imwe nzvimbo ichatungamira kune nyowani IP kero.Place for DNS propagation time (typically 24-48 hours for full global propagation).

Multi- Location Deployment

Kuti uwane kuwanikwa kwakanyanya uye kuwanikwa kwepasi rose, funga nezvekuisa munzvimbo dzakasiyana-siyana:

Usaisa Zvimwe
  • Global content delivery
  • Geographic load balancing
  • Kudzoreredza kwekadhi
  • Kutevedzera mitemo yedata yekugara
  • Yakaderera latency yevanoshandisa vekunze
Kuvandudza
  • DNS-based kutakura kugadzikana (GeoDNS)
  • CDN kubatanidzwa (Cloudflare, nezvimwewo)
  • Database replication pakati penzvimbo
  • Yakabatanidzwa yekuchengetera mhinduro
  • Failover yekushandisa-level
Need help with multi-region deployment? Contact our solutions team at solutions@vps.org for architecture consulting.