Skip to content
cPanel UAPI
/
DNS
/
Retrieve cPanel-generated subdomains for a domain

cPanel UAPI (11.136.0.4)

UAPI accesses the cPanel interface's features. Use this API to access and modify cPanel account data and settings.

https://cpanel.net/developers/
Download OpenAPI description
cpanel.openapi.json
cpanel.openapi.yaml
Overview
URL

https://cpanel.net/support/

WebPros International, LLC

cs@cpanel.net

License

cPanel License

Terms of Service

Languages
Servers
Mock server

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

A server running cPanel.

https://{host}:{port}/execute/

API Token Management

API Development Tools / API Token Management

Operations

Batch

The Batch module for UAPI.

Operations

SSE Task Management

API Development Tools / SSE Task Management

Operations

URL Parsing

API Development Tools / URL Parsing

Operations

External Authentication

Authentication / External Authentication

Operations

Two-Factor Settings

Authentication / Two-Factor Settings

Operations

Block IP

Block Ip Addresses / Block IP

Operations

Market Integration

Commerce Integration / Market Integration

Operations

SSL Certificates

Commerce Integration / SSL Certificates

Operations

Contact Information

cPanel Account / Contact Information

Operations

Account Enhancements

The Account Enhancement module for UAPI.

Operations

Account Information

cPanel Account / Account Information

Operations

Account Management

cPanel Account / Account Management

Operations

Contact Information

cPanel Account / Contact Information

Operations

cPanel Features

cPanel Account / cPanel Features

Operations

Disk Quotas

cPanel Account / Disk Quotas

Operations

Personalization

The Personalization module for UAPI.

Operations

Resource Usage and Statistics

cPanel Account / Resource Usage and Statistics

Operations

Subaccount Management

cPanel Account / Subaccount Management

Operations

Team Roles

The Team Roles module for UAPI.

Operations

Team Users

The Team User module for UAPI.

Operations

Backup

The Backup module for UAPI.

Operations

File Restoration

cPanel Account Backups / File Restoration

Operations

Plugins

The Plugins module for UAPI.

Operations

Application Information

cPanel Theme Management / Application Information

Operations

Brand Management

cPanel Theme Management / Brand Management

Operations

Branding Files

cPanel Theme Management / Branding Files

Operations

Browser Cache Management

cPanel Theme Management / Browser Cache Management

Operations

Language

cPanel Theme Management / Language

Operations

Theme Settings

cPanel Theme Management / Theme Settings

Operations

Directory Indexes

Directory Management / Directory Indexes

Operations

Directory Privacy

Directory Management / Directory Privacy

Operations

Directory Protection

Directory Management / Directory Protection

Operations

DNS

The DNS module for UAPI.

Operations

Return whether domains only resolve locally

Request

This function indicates whether the account's domains resolve exclusively to this server.

Security
BasicAuth
Query
domainstring(domain)required

The domain to check.

Note:

To check multiple domains, duplicate or increment the parameter name. For example, to exclude three domains, you could:

  • Use the domain parameter multiple times.
  • Use the domain, domain-1, and domain-2 parameters.
Examples:
domain=domain=example.com&domain-1=example1.com&domain-2=example2.com
domain=domain=example.com&domain=example1.com&domain=example2.com
domain=example.com
uapi --output=jsonpretty \
  --user=username \
  DNS \
  ensure_domains_reside_only_locally \
  domain='example.com'

Responses

HTTP Request was successful.

Bodyapplication/json
apiversioninteger

The version of the API.

Example: 3
funcstring

The name of the method called.

Example: "ensure_domains_reside_only_locally"
modulestring

The name of the module called.

Example: "DNS"
resultobject
Response
application/json
{
  "apiversion": 3,
  "func": "ensure_domains_reside_only_locally",
  "module": "DNS",
  "result": {
    "data": [ … ],
    "errors": null,
    "messages": null,
    "metadata": { … },
    "status": 1,
    "warnings": null
  }
}

Retrieve cPanel-generated subdomains for a domain

Request

This function retrieves the list of subdomains that cPanel automatically generates for a given domain. These include proxy subdomains such as webmail, mail, and cpanel, as well as other system-generated domain names.

Security
BasicAuth
Query
domainstring(domain)required

The domain for which to retrieve cPanel-generated subdomains.

Examples:
domain=example.com
uapi --output=jsonpretty \
  --user=username \
  DNS \
  fetch_cpanel_generated_domains \
  domain='example.com'

Responses

HTTP Request was successful.

Bodyapplication/json
apiversioninteger

The version of the API.

Example: 3
funcstring

The name of the method called.

Example: "fetch_cpanel_generated_domains"
modulestring

The name of the module called.

Example: "DNS"
resultobject
Response
application/json
{
  "apiversion": 3,
  "func": "fetch_cpanel_generated_domains",
  "module": "DNS",
  "result": {
    "data": [ … ],
    "errors": null,
    "messages": null,
    "metadata": { … },
    "status": 1,
    "warnings": null
  }
}

Return whether local DNS server is authoritative

Request

This function checks whether the local server is authoritative for the domain's DNS records.

Security
BasicAuth
Query
domainstring(domain)required

The domain to check whether the local server is authoritative for the domain's DNS records.

Note:

To check multiple domains, increment or duplicate the parameter name. For example, domain-0, domain-1, and domain-2.

Examples:
domain=domain-0=example.com domain-1=example1.com domain-2=example2.com
domain=domain=example.com domain=example1.com domain=example2.com
domain=example.com
uapi --output=jsonpretty \
  --user=username \
  DNS \
  has_local_authority \
  domain='example.com'

Responses

HTTP Request was successful.

Bodyapplication/json
apiversioninteger

The version of the API.

Example: 3
funcstring

The name of the method called.

Example: "has_local_authority"
modulestring

The name of the module called.

Example: "DNS"
resultobject
Response
application/json
{
  "apiversion": 3,
  "func": "has_local_authority",
  "module": "DNS",
  "result": {
    "data": [ … ],
    "errors": null,
    "messages": null,
    "metadata": { … },
    "status": 1,
    "warnings": null
  }
}

DNS Information

DNS / DNS Information

Operations

DNS Security

DNS / DNS Security

Operations

Dynamic DNS

DNS / Dynamic DNS

Operations

Email DNS Settings

DNS / Email DNS Settings

Operations

Domain

The Domain module for UAPI.

Operations

Domain

The Domain module for UAPI.

Operations

Domain Information

Domain Management / Domain Information

Operations

Domain Redirection

Domain Management / Domain Redirection

Operations

SubDomain

The SubDomain module for UAPI.

Operations

Virtual Host Information

Domain Management / Virtual Host Information

Operations

Email Accounts

Email / Email Accounts

Operations

Email Filtering

Email / Email Filtering

Operations

Email Forwarding

Email / Email Forwarding

Operations

Email Server Information

Email / Email Server Information.

Operations

Email Suspensions

Email / Email Suspensions

Operations

Mail Server Information

Email / Mail Server Information

Operations

Mailbox Management

Email / Mailbox Management

Operations

Mailing Lists

Email / Mailing Lists

Operations

Signing and Encryption (GnuPG Keys)

Email / Signing and Encryption (GnuPG Keys)

Operations

Spam Filtering (Greylisting)

Email / Spam Filtering (Greylisting)

Operations

Spam Management

Email / Spam Management

Operations

Spam Prevention (BoxTrapper)

Email / Spam Prevention (BoxTrapper)

Operations

Webmail Applications

Email / Webmail Applications

Operations

Webmail Sessions

Email / Webmail Sessions

Operations

FTP Accounts

Files / FTP Accounts

Operations

FTP Server Settings

Files / FTP Server Settings

Operations

Image Tools

Files / Image Tools

Operations

Manage Files

Files / Manage Files

Operations

Manage Files

Files / Manage Files

Operations

WebDisk Settings

Files / WebDisk Settings

Operations

Deployment Settings

GIT Management / Deployment Settings

Operations

Repository Management

GIT Management / Repository Management

Operations

InProductSurvey

The InProductSurvey module for cPanel UAPI.

Operations

Database Information

MySQL and MariaDB / Database Information

Operations

Database Management

MySQL and MariaDB / Database Management

Operations

Remote Databases

MySQL and MariaDB / Remote Databases

Operations

User Management

MySQL and MariaDB / User Management

Operations

Pushbullet

The Pushbullet module for UAPI.

Operations

Antivirus Protection (ClamAV)

Optional Applications / Antivirus Protection (ClamAV)

Operations

Calendar and Contacts (DAV)

Optional Applications / Calendar and Contacts (DAV)

Operations

Calendar and Contacts Server

Optional Applications / Calendar and Contacts Server

Operations

cPanel Addons (cPAddons)

Optional Applications / cPanel Addons (cPAddons)

Operations

WordPress Manager Backups

Optional Applications / WordPress Manager Backups

Operations

WordPress Manager Settings

Optional Applications / WordPress Manager Settings

Operations

PostgreSQL Database Management

PostgreSQL / Database Management

Operations

PostgreSQL User Management

PostgreSQL / User Management

Operations

Bandwidth

The Bandwidth module for UAPI.

Operations

Known SSH Hosts Management

Security / Known SSH Hosts Management

Operations

Login Information

Security / Login Information

Operations

cPanel Server Information

Server Information / cPanel Server Information

Operations

Notifications

The Notifications module for UAPI.

Operations

Password Strength

Server Information / Password Strength

Operations

SSH

The SSH module for UAPI.

Operations

ServiceProxy

The ServiceProxy module for UAPI.

Operations

SiteQuality

The SiteQuality module for UAPI.

Operations

Auto-generated SSL Certificates

SSL Certificates / Auto-generated SSL Certificates

Operations

cPanel Account SSL Management

SSL Certificates / cPanel Account SSL Management

Operations

SNI Email Settings

SSL Certificates / SNI Email Settings

Operations

SSL Certificate Management

SSL Certificates / SSL Certificate Management

Operations

Verify Domain Ownership

SSL Certificates / Verify Domain Ownership

Operations

Domain Statistics

Statistics / Domain Statistics

Operations

Weblog Settings

Statistics / Weblog Settings

Operations

UserData

The UserData module for cPanel UAPI.

Operations

EA4

The EA4 module for UAPI.

Operations

PHP

PHP recommendations

Operations

Application Manager

Web Server Management / Application Manager

Operations

ModSecurity

The ModSecurity module for UAPI.

Operations

NginxCaching

The NginxCaching module for UAPI.

Operations

PHP Settings

Web Server Management / PHP Settings

Operations

Handler Management

Website Configuration / Handler Management

Operations

Logs

Website Configuration / Logs

Operations

Mime Type Management

Website Configuration / Mime Type Management

Operations

Site Information

Website Configuration / Site Information

Operations

Site Installation

Website Configuration / Site Installation

Operations

Sitejet

The Sitejet module for UAPI.

Operations