---
title: "Checks the status of the maindomain, any alternate maindomains, and additional domains"
method: GET
path: "/v1/sites/{id}/maindomain/status"
tags: ["Domains"]
---

# Checks the status of the maindomain, any alternate maindomains, and additional domains

`GET /v1/sites/{id}/maindomain/status`

Checks the status of the maindomain, any alternate maindomains, and additional domains

## Path parameters

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

## Response `200`

OK

- MainDomainStatusResponse
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable
  - `result` MainDomainStatus
    - `maindomain` MainDomainDNSInfo
      - `hostname` string — The hostname of the domain
      - `domain_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)
      - `validation_method` 'http' | 'txt' — Validation method to use (http = http, txt = DNS)
      - `validation_errors` string[] — Errors that occurred when validating the domain
      - `ssl_rate_limit` object, nullable
        - `limited` boolean — Whether the domain is rate limited by the certificate authority
        - `certificate_authority` 'google' | 'lets_encrypt' | 'ssl_com' | 'digicert' — Certificate Authority that was used to issue SSL certificates for the site
        - `expires_at` string — The date and time the rate limit will expire
      - `expected_dns_records` DNSRecord[] — DNS records that are expected expected for the domain to be validated and SSL to be issued
        - `name` string — Name of the DNS record
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
        - `value` string — Value of the DNS record
      - `found_dns_records` DNSRecord[] — DNS records that currently exist for the domain
        - `name` string — Name of the DNS record
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
        - `value` string — Value of the DNS record
      - `records_to_remove` DNSRecord[] — DNS records that will need to be removed before the domain can be validated and SSL can be issued
        - `name` string — Name of the DNS record
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
        - `value` string — Value of the DNS record
    - `alternate_maindomain` union
      - MainDomainDNSInfo
        - `hostname` string — The hostname of the domain
        - `domain_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)
        - `validation_method` 'http' | 'txt' — Validation method to use (http = http, txt = DNS)
        - `validation_errors` string[] — Errors that occurred when validating the domain
        - `ssl_rate_limit` object, nullable
          - `limited` boolean — Whether the domain is rate limited by the certificate authority
          - `certificate_authority` 'google' | 'lets_encrypt' | 'ssl_com' | 'digicert' — Certificate Authority that was used to issue SSL certificates for the site
          - `expires_at` string — The date and time the rate limit will expire
        - `expected_dns_records` DNSRecord[] — DNS records that are expected expected for the domain to be validated and SSL to be issued
          - `name` string — Name of the DNS record
          - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
          - `value` string — Value of the DNS record
        - `found_dns_records` DNSRecord[] — DNS records that currently exist for the domain
          - `name` string — Name of the DNS record
          - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
          - `value` string — Value of the DNS record
        - `records_to_remove` DNSRecord[] — DNS records that will need to be removed before the domain can be validated and SSL can be issued
          - `name` string — Name of the DNS record
          - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
          - `value` string — Value of the DNS record
      - EmptyObject — Empty object
    - `additional_domains` MainDomainDNSInfo[] — Additional domains that are associated with the site
      - `hostname` string — The hostname of the domain
      - `domain_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)
      - `validation_method` 'http' | 'txt' — Validation method to use (http = http, txt = DNS)
      - `validation_errors` string[] — Errors that occurred when validating the domain
      - `ssl_rate_limit` object, nullable
        - `limited` boolean — Whether the domain is rate limited by the certificate authority
        - `certificate_authority` 'google' | 'lets_encrypt' | 'ssl_com' | 'digicert' — Certificate Authority that was used to issue SSL certificates for the site
        - `expires_at` string — The date and time the rate limit will expire
      - `expected_dns_records` DNSRecord[] — DNS records that are expected expected for the domain to be validated and SSL to be issued
        - `name` string — Name of the DNS record
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
        - `value` string — Value of the DNS record
      - `found_dns_records` DNSRecord[] — DNS records that currently exist for the domain
        - `name` string — Name of the DNS record
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
        - `value` string — Value of the DNS record
      - `records_to_remove` DNSRecord[] — DNS records that will need to be removed before the domain can be validated and SSL can be issued
        - `name` string — Name of the DNS record
        - `type` 'A' | 'AAAA' | 'CNAME' | 'TXT' — Type of DNS record
        - `value` string — Value of the DNS record
    - `errors` string[] — Errors that occurred when checking DNS records

## 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)