# list_services
The EvoShield list_services GET endpoint returns a list of all active services on the account.
Parameters
account
: The account key - which can be found in the Settings area of the Evolution Host client area: https://evolution-host.com/controlPanelResponse
JSON array of service objects, each containing the service id, hostname, and type properties. Once obtained via list_services, the service ID can then be used for specifying which service you'd like to interact with in other API endpoints.
service_key
: A unique key assigned to each EvoShield compatible service - This key should be used for any service specific API endpoints.hostname
: The hostname of the service (VPS).protected_ip
: The main IP address being protected by the service (Remote Protection).type
: The type of service (VPS or Remote Protection).Example Call (PHP)
$url = "https://evolution-host.com/api.php";
$action = "list_services";
$callData = http_build_query([
'account' => 'YOUR_ACCOUNT_KEY', //Obtain key from the Evolution Host client panel
'action' => $action,
]);
$ch = curl_init($url . '?' . $callData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPGET, true);
$result = curl_exec($ch);
if($result != false)
{
$result = json_decode($result);
if(json_last_error() !== JSON_ERROR_NONE)
{
echo 'JSON Error: ' . json_last_error_msg();
}
echo '<pre>' . json_encode($result, JSON_PRETTY_PRINT) . '</pre>';
}
curl_close($ch);
Example JSON Response
[
{
"service_key": "ExW80BfV5DP2er3045x5RhmimJvdJ2Zs",
"hostname": "myvps",
"type": "VPS"
},
{
"service_key": "70ncOHxecDgdNc2mofqnyzicgbFrnjkx",
"hostname": "my-other-vps",
"type": "VPS"
},
{
"service_key": "OTaaFnM0m74VO5A6TjPD8LwLTC4Um32K",
"protected_ip": "31.29.199.11",
"type": "Remote Protection"
},
{
"service_key": "NQQjTRZi5GHtp47TEgXT0uVZOnsL4zOz",
"protected_ip": "86.56.56.41",
"type": "Remote Protection"
},
]