List All Locations
Retrieve a list of all available datacenter locations where you can deploy VPS servers.
Query Parameters
| Parameter |
Type |
Required |
Description |
region |
string |
No |
Filter by region: north-america, europe, asia, oceania |
available |
boolean |
No |
Show only locations currently accepting new servers |
Example Request
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);
Example Response
{
"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
}
}
]
}
Response Fields
| Field |
Type |
Description |
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 |
Response Status Codes
| 200 |
Successfully retrieved locations list |
| 401 |
Unauthorized - Invalid or missing authentication token |