Copy
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/locations" \
-H "X-Admin-Key: your_admin_key"
Copy
[
{
"location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"location_code": "ua-odesa-1",
"location_name": "SpiderHub Odesa",
"country_code": "UA",
"max_modems": 20,
"wireguard_ip": "10.100.0.2",
"status": "online",
"last_heartbeat": "2025-01-15T12:30:00.000000",
"modem_count": 4,
"online_modem_count": 4,
"created_at": "2025-01-01T10:00:00.000000",
"updated_at": "2025-01-15T12:30:00.000000"
}
]
SpiderProxy (Admin)
List Locations
List all proxy locations (SpiderHub deployments)
GET
https://spideriq.ai
/
api
/
v1
/
admin
/
proxy
/
locations
Copy
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/locations" \
-H "X-Admin-Key: your_admin_key"
Copy
[
{
"location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"location_code": "ua-odesa-1",
"location_name": "SpiderHub Odesa",
"country_code": "UA",
"max_modems": 20,
"wireguard_ip": "10.100.0.2",
"status": "online",
"last_heartbeat": "2025-01-15T12:30:00.000000",
"modem_count": 4,
"online_modem_count": 4,
"created_at": "2025-01-01T10:00:00.000000",
"updated_at": "2025-01-15T12:30:00.000000"
}
]
This endpoint requires Admin API Key authentication via the
X-Admin-Key header.Query Parameters
Include offline locations in the response
Response
Array of location objects
Show Location object
Show Location object
UUID of the location
Short code (e.g., “ua-odesa-1”)
Human-readable name (e.g., “SpiderHub Odesa”)
ISO 3166-1 alpha-2 country code
Location status:
online, offline, degradedWireGuard VPN IP address
ISO 8601 timestamp of last agent heartbeat
Total number of modems at this location
Number of online modems
Copy
curl -X GET "https://spideriq.ai/api/v1/admin/proxy/locations" \
-H "X-Admin-Key: your_admin_key"
Copy
[
{
"location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"location_code": "ua-odesa-1",
"location_name": "SpiderHub Odesa",
"country_code": "UA",
"max_modems": 20,
"wireguard_ip": "10.100.0.2",
"status": "online",
"last_heartbeat": "2025-01-15T12:30:00.000000",
"modem_count": 4,
"online_modem_count": 4,
"created_at": "2025-01-01T10:00:00.000000",
"updated_at": "2025-01-15T12:30:00.000000"
}
]
⌘I