When you create a zone on NS1 Managed DNS, the system automatically creates a name server (NS) record with multiple answers. Each answer is an authoritative name server for your zone. You must provide this list of authoritative name servers to your domain registrar when delegating the zone to NS1.
Note that each zone may have a different set of name servers assigned to it. To assign the same set of name servers to every zone you create, submit a support ticket or send an email to support@ns1.com. Optionally, an NS1 support team representative can reassign any existing zone to a new set of name servers.
NS1 strongly recommends that you do not modify your NS records manually. Doing so does not impact your assigned name servers.
To view a zone's assigned name servers (NS records) via the NS1 portal:
-
Log into the NS1 portal, and navigate to the Zones page from the main navigation.
-
Select a zone from the list.
-
Click the NAMESERVERS tab to view your assigned name servers.
To view a zone's assigned name servers (NS records) via API:
Run the following GET command below to view a zone’s details.
curl -X GET -H 'X-NSONE-Key: $API_KEY' https://api.nsone.net/v1/zones/:zone
For example:
curl -X GET -H 'X-NSONE-Key: 4L7MwbRUZ3e2BQO6xGiN' https://api.nsone.net/v1/zones/example.com
The response includes a section called, dns_servers
which lists the four name servers that are authoritative for the zone. For example:
{ "id": "520422af9f782d37dffb588b", "hostmaster": "hostmaster@nsone.net", "ttl": 3600, "nx_ttl": 3600, "retry": 7200, "zone": "example.com", "refresh": 43200, "expiry": 1209600, "dns_servers": [ "dns1.p03.nsone.net", "dns2.p03.nsone.net", "dns3.p03.nsone.net", "dns4.p03.nsone.net" ], "networks": [0], "network_pools": ["p03"], "primary": { "enabled": false, "secondaries": [] }, "records": [ { "id": "520422af9f782d37dffb5890", "type": "NS", "tier": 1, "ttl": 3600, "short_answers": [ "dns1.p03.nsone.net", "dns2.p03.nsone.net", "dns3.p03.nsone.net", "dns4.p03.nsone.net" ], "domain": "example.com" }, { "id": "520519509f782d58bb4df419", "type": "A", "tier": 1, "ttl": 3600, "short_answers": [ "1.2.3.4" ], "domain": "www.example.com" } ], "meta": {} }
From the example response above, we see that the following name servers are assigned to this zone:
- dns1.p03.nsone.net
- dns2.p03.nsone.net
- dns3.p03.nsone.net
- dns4.p03.nsone.net
For more information, refer to the NS1 API documentation at https://www.ns1.com/api.