---
title: "List additional domains (aliases) for the site"
method: GET
path: "/v1/sites/{id}/domains"
tags: ["Domains"]
---

# List additional domains (aliases) for the site

`GET /v1/sites/{id}/domains`

Get additional domains for given site

## Path parameters

- `id` integer, required — ID of the Site you are interacting with

## Query parameters

- `search` string — Search for a domain by its name
- `page` integer
- `per_page` integer
- `sort` 'domain' | 'domain_type' | 'hostname_status' | 'ssl_status' | 'validation_method'
- `direction` 'asc' | 'desc' | 'ASC' | 'DESC' — Direction to sort results in (asc = ascending, desc = descending)

## Response `200`

OK

- GetDomainAliasesResponse
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable
  - `metadata` object
    - `page` integer — Page number of the results
    - `page_size` integer — Number of results per page
    - `total` integer — Total number of results
    - `sort` string — Sorting criteria
    - `direction` 'asc' | 'desc' — Sorting direction
  - `result` object
    - `additional_domains` DomainAlias[]
      - `id` integer — ID of the domain alias (additional domain)
      - `base_domain` string — Base domain without any subdomains. Example is for sub.domain.tld
      - `custom_ssl` union — custom ssl information for this domain. ssl is managed by Cloudflare if not present
        - CustomSSLResponse
          - `id` string, uuid — custom ssl record identifier
          - `site_id` integer — id of the site associated with custom ssl record
          - `serial_number` string — the serial number of this custom ssl certificate
          - `fingerprint` string — the SHA256 fingerprint of this custom ssl certificate
          - `issuer` string — the issuer of this custom ssl certificate
          - `uploaded_on` string, date-time — the date this custom ssl certificate was uploaded
          - `issued_on` string, date-time — the date this custom ssl certificate was issued
          - `expires_on` string, date-time — the date this custom ssl certificate will expire
          - `domains` string[] — the Rocket.net domains that are associated with this custom ssl certificate
        - unknown
      - `certificate_authority` 'google' | 'lets_encrypt' | 'ssl_com' | 'digicert' — Certificate Authority that was used to issue SSL certificates for the site
      - `display_domain` string — Full domain name of the domain (UTF-8 characters present)
      - `domain` string — Full domain name of the domain (UTF-8 converted to punycode)
      - `domain_id` integer — ID of the domain alias (additional domain)
      - `domain_type` 'normal' | 'subdomain' | 'www' — Type of domain (normal = apex [i.e. domain.tld], subdomain = subdomain other than www, www = www.$domain)
      - `dns_provider` string — Where the DNS records for the domain live
      - `hostname_status` 'active' | 'active_redeploying' | 'blocked' | 'deleted' | 'moved' | 'pending' | 'pending_blocked' | 'pending_deletion' | 'pending_migration' | 'pending_provisioned' | 'provisioned' | 'test_active' | 'test_active_apex' | 'test_blocked' | 'test_failed' | 'test_pending' — Status of the domain (moved will require re-creation by changing the domain)
      - `ssl_status` 'active' | 'backup_issued' | 'deactivating' | 'deleted' | 'deletion_timed_out' | 'deployment_timed_out' | 'expired' | 'holding_deployment' | 'inactive' | 'initializing' | 'initializing_timed_out' | 'issuance_timed_out' | 'pending_cleanup' | 'pending_deletion' | 'pending_deployment' | 'pending_expiration' | 'pending_issuance' | 'pending_validation' | 'staging_active' | 'staging_deployment' | 'validation_timed_out' — Status of the SSL Cert (pending_validation when DNS cannot be validated, active when live)
      - `sub_domain` string — If this domain is a sub-domain this will be the sub-domain value. Otherwise it will be the domain without TLD. Example is for sub.domain.tld
      - `validation_method` 'http' | 'txt' — Validation method to use (http = http, txt = DNS)
      - `validation_records` ValidationRecord[]
        - `type` 'a' | 'cname' | 'txt' — Type of DNS record
        - `name` string — Name of the DNS record
        - `value` string — Value of the DNS record
        - `status` 'active' | 'active_redeploying' | 'backup_issued' | 'blocked' | 'deactivating' | 'deleted' | 'deletion_timed_out' | 'deployment_timed_out' | 'expired' | 'holding_deployment' | 'inactive' | 'initializing' | 'initializing_timed_out' | 'issuance_timed_out' | 'moved' | 'pending' | 'pending_blocked' | 'pending_cleanup' | 'pending_deletion' | 'pending_deployment' | 'pending_expiration' | 'pending_issuance' | 'pending_migration' | 'pending_provisioned' | 'pending_validation' | 'provisioned' | 'staging_active' | 'staging_deployment' | 'test_active' | 'test_active_apex' | 'test_blocked' | 'test_failed' | 'test_pending' | 'validation_timed_out' — Status of the domain (pending_validation when DNS cannot be validated, active when live)

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Not authorized to access endpoint
- `404` — Given site not found for user
- `405` — Invalid input
- `500` — Internal error

---

[API](https://skmtc.net/rocket/apis/rocket-net-api.md) · [All operations](https://skmtc.net/rocket/apis/rocket-net-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rocket/rocket-net-api/versions/db0dcbbc5764/schema)