How to Write Your Own Utilities Using Plesk CLI and API-RPC

Every now and then the Plesk development team gets requests to expand the functionality of existing command line utilities or to add new ones. We try to take such requests into account, but, seeing as major Plesk releases only happen roughly once a year, many months may pass before a customer’s vision becomes a reality. However, there is another way to get the desired functionality. If you find yourself in a situation where no existing utility does exactly what you want to, you can create your own using Plesk API-RPC and expanding upon the functionality of existing Plesk CLI utilities.

Custom utilities are created by using a command line API client to send an API call to Plesk (local or remote) and receive the response, or by incorporating an existing Plesk CLI utility into a shell script. Our GitHub repository contains usable examples of command line API clients in a dozen different programming languages. You only need to modify them and, potentially, process the output (which will come in the form of an .xml response packet). This way you can create a utility that is able to do anything you can do via API (by the way, to learn what you can do via API, take a look at our API-RPC guide).

I will illustrate the concept with two examples. The first is written in bash, and it tells you on which Plesk server a particular domain is hosted. The second is written in PHP, and it displays resource usage data for all subscriptions on the server.

Where is

Imagine that you are a Plesk administrator, running a number of Plesk servers. You need to make some changes to the configuration of the domain, but you cannot quite remember on which server the domain is hosted. Yes, you can log in to your billing solution (if you have one), or check every server in turn, but… doesn’t it sound like too much effort? There is a better solution. You can run the following custom script making use of the Plesk CLI utility ( domain-related ) instead:

First, create a file named and paste the following code into the file:



for SERVER in $SERVERS; do
   ssh root@${SERVER} "plesk bin domain -i ${DOMAIN} > /dev/null 2>&1"
   if [ 0 -eq $? ]; then
       echo "Domain '${DOMAIN}' found on '${SERVER}'"

Put the hostnames of all Plesk servers to be searched after SERVERS. Separate individual hostnames with the “space” symbol. Make the file executable:

chmod +x

and run it:


The script will search all the servers you specify and provide output of the following form:

Domain '' found on ''

Getting detailed resource usage information

If you need to retrieve information about resource usage on the server for every subscription and store it in a file, the following script will help you. To use it, first create a file named PleskApiClient.php and paste the code found here into it, then create a file named getstats.php and paste the following code inside:

#!/usr/bin/env php

$host = getenv('REMOTE_HOST');
$login = getenv('REMOTE_LOGIN') ?: 'admin';
$password = getenv('REMOTE_PASSWORD');

$client = new PleskApiClient($host);
$client->setCredentials($login, $password);

$request = <<<EOF

$response = new SimpleXMLElement($client->request($request));
$data = array();

foreach($response->customer->get->result as $customer) {
    $data[(int) $customer->id] = array(
        'id' => (int) $customer->id,
        'login' => $customer->data->gen_info->login,
        'email' => $customer->data->gen_info->email

$customers = array_keys($data);
$customers = array_map(function($n){ return "<owner-id>$n</owner-id>";}, $customers);
$customers = implode("\n", $customers);

$request = <<<EOF

$response = new SimpleXMLElement($client->request($request));

echo "subscription_id;client_id;login;email;traffic;subdomains;webusers;mailboxes;redirects;mailgroups;autoresponders;maillists;mysql_db;mssql_db;webapps;traffic_prevday;domains;sites\n";

foreach($response->webspace->get->result as $subscription) {
    echo implode(';', array_merge(
            $data[(int) $subscription->{'filter-id'}],
        ) . "\n";

Place both files in the same directory and run the script like this:

REMOTE_PASSWORD=<Plesk admin password> REMOTE_HOST=<Plesk server hostname or IP> /usr/bin/php getstats.php

The script will output the resource usage information in the semicolon-delimited CSV format, so you can, for example, import it in Excel. Here is a sample output:

5;wunsch_alessandr;[email protected];0;0;0;0;0;0;0;0;0;0;1;0
7;alexandro0;[email protected];0;0;0;0;0;0;0;0;0;0;1;0
9;devon5;[email protected];303;0;0;0;0;0;0;0;0;0;1;0
13;crona.shane75;[email protected];344;0;0;0;0;0;0;0;0;0;2;1
14;myles;[email protected];1424;0;0;1;0;0;0;0;0;0;1;0

These two examples are merely the tip of the iceberg – you can create all kinds of custom utilities with this method. Your imagination (well, and your programming skills, too) is the limit here. Remember to refer to the API-RPC guide, and we also recommend you to use a browser extension for working with API to make your life easier. If you are using Google Chrome, Postman is a fine choice, but there are others as well – shop around and see what fits you best. You can also use the XML-RPC API Explorer Plesk extension – it is a handy tool to help you create and validate your API requests.


  1. Hey there,
    I’am searching a way to find Domains & subdomains and list them WITH their configured PHP-Version.

    Therefor I use packet->domain->get with no filter and dataset->gen_info to get all Domains (have to figure out how to get subdomains) and then for each Domain I tryed packet>Domain>get-physical-hosting-descriptor with filter->domain-name->#DOMAINNAME#…

    But I can’t find the php-version-number in the Reply!?

    May you assist?

    Would be really great 🙂

    • Thanks for the comment, Oliver.
      Unfortunately, at the present moment there is no way to obtain the PHP version for a domain via API. In Plesk 12.5 we added the method, which will enable you to get the information you seek in a slightly roundabout way. You can first retrieve the PHP handler ID using the method, then retrieve the properties of the handler, including the PHP version.

      Request sample:

      Response sample:
      <packet version=”″>

  2. Is there any way to set the version? (I have multiple php versions installed)

Add a Comment

Your email address will not be published. Required fields are marked *


  • Yes, please, I agree to receiving my personal Plesk Newsletter! WebPros International GmbH and other WebPros group companies may store and process the data I provide for the purpose of delivering the newsletter according to the WebPros Privacy Policy. In order to tailor its offerings to me, Plesk may further use additional information like usage and behavior data (Profiling). I can unsubscribe from the newsletter at any time by sending an email to [email protected] or use the unsubscribe link in any of the newsletters.

  • Hidden
  • Hidden
  • Hidden
  • Hidden
  • Hidden
  • Hidden

Related Posts

Knowledge Base

Plesk uses LiveChat system (3rd party).

By proceeding below, I hereby agree to use LiveChat as an external third party technology. This may involve a transfer of my personal data (e.g. IP Address) to third parties in- or outside of Europe. For more information, please see our Privacy Policy.