We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.

We will continue to maintain our API documentation on this server.

Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 68

(cPanel >> Home >> Advanced >> API Shell)


This interface allows you to run cPanel API functions interactively.


This feature uses live data from your server. API function calls may change or delete data on your server, which can cause your server to fail.

  • Read the documentation for a function call thoroughly before you use it in the API Shell interface, a script, or through any other method.
  • To see an example of the output from a specific function call that uses test data, read the Example section for that function call in our Developer Documentation.

Enable the cPanel API Shell

To use this feature, your system administrators must enable it for you. Ask them to perform the following steps in WHM:

  1. Select On for the cPanel & WHM API Shell (for developers) setting in the System tab of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).
  2. Grant the API Shell feature to the desired users in WHM's Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).
  3. You must use a reseller account to access the API Shell interface.

In This Document

Related Documentation

There is no content with the specified labels

For Hosting Providers

There is no content with the specified labels

Run a cPanel API function

To run a cPanel API function, perform the following steps:

  1. Select the API that you wish to use.


  2. Select the API function that you wish to test from the menu.
  3. Enter the keys and values that you wish to test.
    • To enter more keys and values, click Add.
  4. To filter, sort, or paginate the results, click Show Sort/Filter/Paginate Options.
    1. To select the first record to show from the results, enter the number in the Index of first result to show, zero-based text box or use the menu to select the number.
    2. To limit the number of results to display, enter the maximum number of results in the Maximum # of results to show text box or use the menu to select the number.
    3. To filter the results, click Add in the Filters section of the interface.
      • You can specify the field by which you wish to filter the results, the conditions, and the Term to apply to the conditions.
      • To use more than one filter, click Add for each additional filter that you wish to specify.
    4. To sort the results, click Add in the Sorts section of the interface.
      • You can specify the field by which you wish to sort the results, the conditions, and whether you wish to reverse the sort order.
      • To use more than one sort method, click Add for each additional sort method that you wish to specify.
    5. To limit the columns to display, click Add in the Columns section of the interface.
      • Enter the column number in the Column text box.
      • To specify more columns to display, click Add.
  5. Click Submit.

API call results

The results appear in the API call response section of the interface.

You can view the results in Table view, Tree view, or the Raw response.


The Raw response separates the API call's response from the HTTP headers.