WHM API.
Download OpenAPI description
Overview
URL
WebPros International, LLC
License
Languages
Servers
Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/
A server running WHM.
https://{host}:{port}/json-api/
Query
The WHM API 1 function to call.
Important:
Specify a command parameter for each function.
Note:
Include the function's input parameters as a URI-encoded list after the function name. For example, to call the killdns function with a domain parameter value of example.com directly you would use:
killdns?domain=example.com
To call this function using the batch function, URI-encode the command and pass it as part of the batch function:
/json-api/batch?api.version=1&command=killdns%3Fdomain%3Dexample.com
You can call the same function multiple times within a single batch API call. For example:
/json-api/batch?api.version=1&command=version&command=version&command=version
Example: command=version
- Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/batch
- A server running WHM.
https://whm-server.tld:2087/json-api/batch
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/batch?command=version&abort_on_error=0'Response
application/json
{ "data": { "result": [ … ] }, "metadata": { "command": "batch", "reason": "OK", "result": 1, "version": 1 } }
- Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/cors_proxy_get
- A server running WHM.
https://whm-server.tld:2087/json-api/cors_proxy_get
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/cors_proxy_get?url=http%3A%2F%2Fwww.example.com'Response
application/json
{ "data": { "_cp_redirects": [ … ], "content": "<!doctype html>\\n<html>\\n<head>\\n <title>Example Domain</title>\\n\\n <meta charset=\\\"utf-8\\\" />\\n <meta http-equiv=\\\"Content-type\\\" content=\\\"text/html; charset=utf-8\\\" />\\n <meta name=\\\"viewport\\\" content=\\\"width=device-width, initial-scale=1\\\" />\\n <style type=\\\"text/css\\\">\\n body {\\n background-color: #f0f0f2;\\n margin: 0;\\n padding: 0;\\n font-family: -apple-system, system-ui, BlinkMacSystemFont, \\\"Segoe UI\\\", \\\"Open Sans\\\", \\\"Helvetica Neue\\\", Helvetica, Arial, sans-serif;\\n\\n }\\n div {\\n width: 600px;\\n margin: 5em auto;\\n padding: 2em;\\n background-color: #fdfdff;\\n border-radius: 0.5em;\\n box-shadow: 2px 3px 7px 2px rgba(0,0,0,0.02);\\n }\\n a:link, a:visited {\\n color: #38488f;\\n text-decoration: none;\\n }\\n @media (max-width: 700px) {\\n div {\\n margin: 0 auto;\\n width: auto;\\n }\\n }\\n </style>\\n</head>\\n\\n<body>\\n<div>\\n <h1>Example Domain</h1>\\n <p>This domain is for use in illustrative examples in documents. You may use this\\n domain in literature without prior coordination or asking for permission.</p>\\n <p><a href=\\\"https://www.iana.org/domains/example\\\">More information...</a></p>\\n</div>\\n</body>\\n</html>\\n" }, "metadata": { "command": "cors_proxy_get", "reason": "OK", "result": 1, "version": 1 } }
Request
You can call cPanel API and UAPI functions through the WHM API.
This method is useful, for example, when you develop plugins for WHM users, particularly resellers, but need to access cPanel functions. You can make these calls from within either the WHM or cPanel interfaces.
Important:
We recommend that you use the WHM API 1 uapi_cpanel function. The uapi_cpanel function is a more flexible way to call cPanel API functions from WHM. For example, you can use the uapi_cpanel function with the WHM API 1 batch function.
Before calling a cPanel API function via this method, read its documentation. The cPanel API function may require other parameters not listed in this document.
Security
BasicAuth
Query
The UAPI function name.
Important:
Function names are case-sensitive.
Example: cpanel_jsonapi_func=listpopswithdisk
The UAPI module name.
Important:
Module names are case-sensitive.
Example: cpanel_jsonapi_module=Email
The cPanel username for the account through which to call the function.
Make certain that you specify the username in lowercase characters only. cPanel & WHM automatically converts usernames to lowercase when you create a cPanel account. For this reason, if you supply a username that includes some or all capital letters, the call will fail.
Example: cpanel_jsonapi_user=user
The cPanel API version to use.
1— Use cPanel API 1.2— Use cPanel API 2.3— Use UAPI.
Default 2
Enum123
Example: cpanel_jsonapi_apiversion=3
The function's input parameters and their values. You can add any additional parameters supported by the underlying cPanel API function.
Example: domain=example.com
Note:
- Separate multiple
parameter=valuepairs with the ampersand character (&). - You must URI-encode these values.
- Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/cpanel
- A server running WHM.
https://whm-server.tld:2087/json-api/cpanel
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/cpanel?cpanel_jsonapi_func=listpopswithdisk&cpanel_jsonapi_module=Email&cpanel_jsonapi_user=user&cpanel_jsonapi_apiversion=3&Variable+Names+and+Values=string'Response
application/json
{ "data": null, "metadata": { "command": "cpanel", "reason": "OK", "result": 1, "version": 1 } }