NS1 status

Articles in this section

See more

Locating your assigned name servers (NS records)

  • Updated
Follow

When you create a zone in the NS1 portal, 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 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.

Warning

NS1 strongly recommends that you do not manually modify your NS1 records. Doing so does not impact your assigned name servers.

To view a zone's assigned name servers via the NS1 portal:

  1. Navigate to DNS > Zones to view a list of zones associated with your account.

  2. Click the name of the desired zone in the list (in this case, example_zone.com).

  3. Click the Nameservers tab to view your assigned name servers.

To view a zone's assigned NS records via API:

Run the following GET command 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": {} }

As shown in the example response above, 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.

Related articles