---
title: "List the addon domains"
method: GET
path: "/AddonDomain/listaddondomains"
tags: ["AddonDomain"]
---

# List the addon domains

`GET /AddonDomain/listaddondomains`

This function lists the cPanel account's addon domains: the domains that
are parked on a subdomain of the account's primary domain, rather than on
the primary domain itself.

**Note:**

Use the `Park::listparkeddomains` function for the domains parked on the
primary domain.

## Query parameters

- `regex` string
- `return_https_redirect_status` 0 | 1

## Response `200`

HTTP Request was successful.

- object
  - `data` object[] — One entry for each addon domain on the account, sorted by domain name.
    - `basedir` string — The addon domain's document root, relative to the account's home directory.
    - `can_https_redirect` 0 | 1 — Whether the system can redirect the addon domain to `HTTPS`. The system only returns this field when you pass the `return_https_redirect_status` parameter. * `1` - The system can redirect the addon domain. * `0` - The system cannot redirect the addon domain.
    - `dir` string, path — The absolute path to the addon domain's document root.
    - `domain` string, domain — The addon domain.
    - `domainkey` string — The subdomain that the addon domain is parked on, in the underscore-separated `subdomain_rootdomain` form. Pass this value as the `subdomain` parameter of the `AddonDomain::deladdondomain` function.
    - `fullsubdomain` string, domain — The fully qualified name of the subdomain that the addon domain is parked on.
    - `is_https_redirecting` 0 | 1 — Whether the system currently redirects the addon domain to `HTTPS`. The system only returns this field when you pass the `return_https_redirect_status` parameter. * `1` - The system redirects the addon domain. * `0` - The system does **not** redirect the addon domain.
    - `reldir` string — The addon domain's document root, relative to the account's home directory and prefixed with `home:`.
    - `rootdomain` string, domain — The domain that the addon domain's subdomain belongs to.
    - `status` string — The addon domain's rewrite status, or the URL that it redirects to.
    - `subdomain` string — The label of the subdomain that the addon domain is parked on, without the root domain.
    - `web_subdomain_aliases` string[] — The built-in service subdomain aliases, for example `www`, that the system serves for the addon domain.
  - `errors` string[], nullable
  - `messages` string[], nullable
  - `metadata` object
    - `transformed` integer
  - `status` 0 | 1 — * `1` — Success. * `0` — Failed. Check the `errors` field for more details.
  - `warnings` string[], nullable

---

[API](https://skmtc.dev/cpanel/apis/cpanel-uapi.md) · [All operations](https://skmtc.dev/cpanel/apis/cpanel-uapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cpanel/cpanel-uapi/revisions/632e2f8e6d04/schema)