---
title: "Return whether domains use recognized nameservers"
method: GET
path: "/DNS/ensure_domains_use_recognized_nameservers"
tags: ["DNS", "DNS Information"]
---

# Return whether domains use recognized nameservers

`GET /DNS/ensure_domains_use_recognized_nameservers`

## Request

- Base URL: `https://cpanel-server.tld:2083/execute`
- URL: `https://cpanel-server.tld:2083/execute/DNS/ensure_domains_use_recognized_nameservers`
- Auth: HTTP basic

This function indicates whether the account's domains' nameservers resolve to an IP address that this server recognizes as its own. It predicts the outcome of the create-time nameserver validation that runs when a domain is added to the account, without performing any privileged action.

## Query parameters

- `domain` string, domain, required

## Response `200`

HTTP Request was successful.

- object
  - `apiversion` integer: The version of the API.
  - `func` string: The name of the method called.
  - `module` string: The name of the module called.
  - `result` object
    - `data` object[], nullable: The results from each domain parameter's nameserver check. * `null` - The domain would pass the create-time nameserver validation. * An object describing why it would not, with a `type` field set to one of: * `domain_not_registered` - The domain has no resolvable nameserver IP addresses. * `unrecognized_nameservers` - The domain's nameservers do not resolve to an IP address this server recognizes as its own. **Note:** The function returns the results from the domains in the same order that you called them. The entire call fails, rather than returning a per-domain result, when the check cannot be reliably determined from the calling user's process — for example, on a cPanel Cloud controller, or when the validator fails for a reason other than the two outcomes above. Treat a failed call as "unable to determine" rather than as every domain failing.
      - `message` string: The validator's own localized message.
      - `type` 'domain_not_registered' | 'unrecognized_nameservers': A short machine-readable reason code.
    - `errors` string[], nullable: List of errors if the API failed.
    - `messages` string[], nullable: List of messages generated by the API.
    - `metadata` object
      - `transformed` 1: Post-processing may have transformed the data.
    - `status` 0 | 1: * `1` - Success. * `0` - Failed. Check the `errors` field for more details.
    - `warnings` string[], nullable: List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.

## Changes

- **2026-09-12** `99adb57e7a5d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cpanel/apis/cpanel-uapi/changes/DNS/ensure_domains_use_recognized_nameservers/get.md)

---

[API](https://skmtc.dev/cpanel/apis/cpanel-uapi.md) - [All operations](https://skmtc.dev/cpanel/apis/cpanel-uapi/llms.txt) - [OpenAPI document](https://skmtc.dev/cpanel/apis/cpanel-uapi/revisions/05239220da37?raw)