Skip to content
Download OpenAPI description
Overview
Languages
Servers
Mock server

https://api.docs.cpanel.net/_mock/specifications/whm.openapi/

A server running WHM.

https://{host}:{port}/json-api/

Restore Account

Account Restoration / Restore Account

Operations

Restore Queue Management

Account Restoration / Restore Queue Management

Operations

Restore Queue Reporting

Account Restoration / Restore Queue Reporting

Operations

Account Creation

Accounts Creation / Accounts

Operations

Account Enhancements

Accounts / Account Enhancements

Operations

Account Management

Accounts / Account Management

Operations

Bandwidth and Disk Quotas

Accounts / Bandwidth and Disk Quotas

Operations

Domain Information

Accounts / Domain Domain Information

Operations
Operations

Styles

The Styles and Themes module for WHM API 1.

Operations
Operations

API Execution

API Development Tools / API Execution

Operations

API Statistics

API Development Tools / API Statistics

Operations

API Token Management

API Development Tools / API Token Management

Operations

Applications

API Development Tools / Applications

Operations

Session

API Development Tools / Session

Operations

Authentication Providers

Authentication / Authentication Providers

Operations

External Authentication

Authentication / External Authentication

Operations

Login URL

Authentication / Login URL

Operations

SSH Keys and Connections

Authentication / SSH Keys and Connections

Operations

Two-Factor Authentication

Authentication / Two-Factor Authentication

Operations

Backup Destination

Backups / Backup Destination

Operations

Backup or Restore

Backups / Backup or Restore

Operations

Backup Settings

Backups / Backup Settings

Operations

Legacy Migration

Backups / Legacy Migration

Operations

Market Integration

Commerce Integration / Market Integration

Operations

Sitejet

The Sitejet module for WHM API.

Operations

Product Management

cPanel Market / Product Management

Operations

Provider Management

cPanel Market / Provider Management

Operations

Support Access

cPanel Support Tickets / Support Access

Operations

Ticket Management

cPanel Support Tickets / Ticket Management

Operations

Customizations

The Customizations module for WHM API 1.

Operations

Manage MySQL Server

Databases / Manage MySQL Server

Operations

MySQL Databases

Databases / MySQL Databases

Operations

PostgreSQL Databases

Databases / PostgreSQL Databases

Operations

Remote MySQL Databases

Databases / Remote MySQL Databases

Operations

DNS Cluster Settings

DNS / DNS Cluster Settings

Operations
Operations
Operations

Domain Management

DNS / Domain Management

Operations

Domain Management

DNS / Domain Management

Operations
Operations

Service Records

DNS / Service Records

Operations

Feature Access

Hosting Plans / Feature Access

Operations

Feature Lists

Hosting Plans / Feature Lists

Operations

Hosting Plan Extensions

Hosting Plans / Hosting Plan Extensions

Operations

Hosting Plans

Hosting Plans / Hosting Plans

Operations

Return current user's available hosting plans

Request

This function lists the authenticated user's available hosting plans (packages).

Important:

This function only returns packages that the authenticated user can access and use during account creation.

Security
BasicAuth
Query
wantstring

The permissions of packages that you wish to list.

  • all — All packages on the system.
  • creatable — Packages that the authenticated user can use for accounts.
  • editable — Packages that the authenticated user can edit.
  • viewable — Packages that the authenticated user can view.
Default "all"
Enum"all""creatable""editable""viewable"
Example: want=all
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/listpkgs?want=all'

Responses

HTTP Request was successful.

Bodyapplication/json
dataobject
metadataobject
Response
application/json
{ "data": { "pkg": [] }, "metadata": { "command": "listpkgs", "reason": "OK", "result": 1, "version": 1 } }

Request

This function matches the server's hosting plans (packages) against your criteria.

Note:

If you do not include any input parameters, the function lists all of the server's packages.

Security
BasicAuth
Query
_PACKAGE_EXTENSIONSstring

A space-separated list of one or more of the hosting plan's package extensions.

Example: _PACKAGE_EXTENSIONS='ext1 ext2 ext3'
BWLIMITinteger or string

The hosting plan's bandwidth limit.

  • unlimited — The hosting plan allows unlimited bandwidth.
Example: BWLIMIT=unlimited
One of:
>= 0
integer(megabytes)>= 0
CGIinteger

Whether CGI is enabled for the hosting plan.

  • 1 — Enabled.
  • 0 — Disabled.
Enum10
Example: CGI=1
CPMODstring

The hosting plan's cPanel interface theme.

Example: CPMOD=jupiter
DIGESTAUTHstring

Whether the hosting plan enables Digest Authentication.

  • y — Enabled.
  • n — Disabled.
Enum"y""n"
Example: DIGESTAUTH=n
FEATURELISTstring

The hosting plan's feature list.

Example: FEATURELIST=myfeaturelist
HASSHELLinteger

Whether shell access is enabled for the hosting plan.

  • 1 — Enabled
  • 0 — Disabled.
Enum10
Example: HASSHELL=1
IPstring

Whether the hosting plan grants accounts a dedicated IP address.

  • y — Dedicated IP address.
  • n — Shared IP address.
Enum"y""n"
Example: IP=n
LANGstring(ISO-3166-1 (alpha-2))

The hosting plan's locale.

Example: LANG=en
MAX_DEFER_FAIL_PERCENTAGEinteger or string

The percentage of failed or deferred email messages that the hosting plan can send per hour before the system rate-limits outgoing mail.

  • unlimited — The hosting plan allows unlimited email messages.
Example: MAX_DEFER_FAIL_PERCENTAGE=unlimited
One of:
>= 0
integer>= 0
MAX_EMAIL_PER_HOURinteger or string

The maximum number of emails that the hosting plan can send in one hour.

  • unlimited — The hosting plan allows unlimited emails per hour.
Example: MAX_EMAIL_PER_HOUR=unlimited
One of:
>= 0
integer>= 0
MAX_EMAILACCT_QUOTAinteger or string

The hosting plan's maximum email account quota size, in megabytes (MB).

  • unlimited — The hosting plan allows an unlimited email account quota size.
Example: MAX_EMAILACCT_QUOTA=unlimited
One of:
>= 1
integer(megabytes)>= 1
MAX_TEAM_USERSinteger or null[ 0 .. 7 ]

The hosting plan's maximum number of Team users.

Example: MAX_TEAM_USERS=7
MAXADDONinteger or string

The hosting plan's maximum number of addon domains.

  • unlimited — The hosting plan allows unlimited addon domains.
Example: MAXADDON=unlimited
One of:
>= 0
integer>= 0
MAXFTPinteger or string

The hosting plan's maximum number of FTP accounts.

  • unlimited — The hosting plan allows for unlimited FTP accounts.
Example: MAXFTP=2
One of:
>= 0
integer>= 0
MAXLSTinteger or string

The hosting plan's maximum number of mailing lists.

  • unlimited — The hosting plan allows an unlimited number of mailing lists.
Example: MAXLST=unlimited
One of:
>= 0
integer>= 0
MAXPARKinteger or string

The hosting plan's maximum number of parked domains (aliases).

  • unlimited — The hosting plan allows unlimited parked domains.
Example: MAXPARK=unlimited
One of:
>= 0
integer>= 0
MAXPOPinteger or string

The hosing plan's maximum number of email accounts.

  • unlimited — The hosting plan's can create unlimited email accounts.
Example: MAXPOP=unlimited
One of:
>= 0
integer>= 0
MAXSQLinteger or string

The hosting plan's maximum number of SQL databases.

  • unlimited — The hosting plan allows unlimited SQL databases.
Example: MAXSQL=unlimited
One of:
>= 0
integer>= 0
MAXSUBinteger or string

The hosting plan's maximum number of subdomains.

  • unlimited — The hosting plan allows unlimited subdomains.
Example: MAXSUB=unlimited
One of:
>= 0
integer>= 0
QUOTAinteger or string

The hosting plan's disk space limit.

  • unlimited — The hosting plan has unlimited disk space.
Example: QUOTA=unlimited
One of:
>= 0
integer(megabytes)>= 0
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/matchpkgs?_PACKAGE_EXTENSIONS=%27ext1+ext2+ext3%27&BWLIMIT=unlimited&CGI=1&CPMOD=jupiter&DIGESTAUTH=n&FEATURELIST=myfeaturelist&HASSHELL=1&IP=n&LANG=en&MAX_DEFER_FAIL_PERCENTAGE=unlimited&MAX_EMAIL_PER_HOUR=unlimited&MAX_EMAILACCT_QUOTA=unlimited&MAX_TEAM_USERS=7&MAXADDON=unlimited&MAXFTP=2&MAXLST=unlimited&MAXPARK=unlimited&MAXPOP=unlimited&MAXSQL=unlimited&MAXSUB=unlimited&QUOTA=unlimited'

Responses

HTTP Request was successful.

Bodyapplication/json
dataobject
metadataobject
Response
application/json
{ "data": { "pkg": {} }, "metadata": { "command": "matchpkgs", "reason": "OK", "result": 1, "version": 1 } }

InProductSurvey

In-product survey information.

Operations

API Authentication

Integrations / API Authentication

Operations

Scripts Hooks

Integrations / Scripts Hooks

Operations

IPv4 Address Settings

IP Address Management / IPv4 Address Settings

Operations

IPv6 Address Settings

IP Address Management / IPv6 Address Settings

Operations

Network Address Translation

IP Address Management / Network Address Translation

Operations

Management

Login Security (cPHulk) / Management

Operations

Reporting

Login Security (cPHulk) / Reporting

Operations

Settings

Login Security (cPHulk) / Settings

Operations

cPanel Account Mail Management

Mail / cPanel Account Mail Management

Operations

Mail DNS Settings

Mail / Mail DNS Settings

Operations

Mail Server Settings

Mail / Mail Server Settings

Operations

Spam Management

Mail / Spam Management

Operations

Spam Protection (Greylisting)

Mail / Spam Protection (Greylisting)

Operations

NGINX Manager

The NGINX Manager module for WHM API 1.

Operations

Account Enhancement Limit

Resellers / Account Enhancement Limit

Operations

Account Limits

Resellers / Account Limits

Operations

Account Permissions

Resellers / Account Permissions

Operations

Account Settings

Resellers / Account Settings

Operations

Reseller Account Management

Resellers / Account Management

Operations
Operations

Configuration Clusters

Server Administration / Configuration Clusters

Operations

Configurations

Server Administration / Configurations

Operations

Connected Applications

Server Administration / Connected Applications

Operations

Connections

Server Administration / Connections

Operations

cPanel Analytics

The cPanel Analytics module for WHM API 1.

Operations

License Management

The Server Administration module for WHM API 1.

Operations

Notifications

Server Administration / Notifications

Operations

Plugin-Based Features

The plugin-based features module for WHM API 1.

Operations

Security

The Security module for WHM API 1.

Operations

Server Nodes

Server Administration / Server Nodes

Operations

Server Profiles

Server Administration / Server Profiles

Operations

Services

Server Administration / Services

Operations

System Information

The Server Administration module for WHM API 1.

Operations

Updates

Server Administration / Updates

Operations

Auto-Generated Certificates

SSL Certificates / Auto-Generated Certificates

Operations

cPanel Account Settings

SSL Certificates / cPanel Account Settings

Operations

SSL Server Settings

SSL Certificates / SSL Server Settings

Operations

Install or Uninstall Package

System Package Management / Install or Uninstall Package

Operations

List Package Information

System Package Management / List Package Information

Operations

Package Manager Settings

System Package Management / Package Manager Settings

Operations

cPanel Account Transfer

Transfers / cPanel Account Transfer

Operations

Transfer Configuration

Transfers / Transfer Configuration

Operations

Transfer Monitoring

Transfers / Transfer Monitoring

Operations

UserData

Scoped userdata storage functions.

Operations

EasyApache Settings

Web Server Configuration / EasyApache Settings

Operations
Operations

PHP-FPM

Web Server Configuration / PHP-FPM

Operations

Rule Settings

Web Server Security (ModSecurity) / Rule Settings

Operations

Rule Vendor Settings

Web Server Security (ModSecurity) / Rule Vendor Settings

Operations

Server Settings

Web Server Security (ModSecurity) / Server Settings

Operations