Nameservers

Get nameservers

Namecheap: domains.dns.getList

GET /domains/:domain/nameservers

Response 200

{
  "data": {
    "domain": "example.com",
    "isUsingOurDns": false,
    "isPremiumDns": false,
    "isUsingFreeDns": false,
    "nameservers": [
      "ns1.cloudflare.com",
      "ns2.cloudflare.com"
    ]
  }
}

---

Set custom nameservers

Point the domain to custom nameservers. Minimum 2 required. This disables Namecheap’s DNS, URL forwarding, and email forwarding.

Namecheap: domains.dns.setCustom

POST /domains/:domain/nameservers

{
  "nameservers": ["ns1.cloudflare.com", "ns2.cloudflare.com"]
}

Response 200

{
  "data": {
    "domain": "example.com",
    "updated": true
  }
}

---

Register a glue nameserver

Create a child nameserver (e.g. ns1.example.com) with an IP address. Required when you want to use your own domain as a nameserver.

Namecheap: domains.ns.create

POST /domains/:domain/ns

{ "nameserver": "ns1.example.com", "ip": "1.2.3.4" }

Response 201

{
  "data": {
    "domain": "example.com",
    "nameserver": "ns1.example.com",
    "ip": "1.2.3.4",
    "isSuccess": true
  }
}

---

Get nameserver info

Namecheap: domains.ns.getInfo

GET /domains/:domain/ns/:nameserver

Response 200

{
  "data": {
    "domain": "example.com",
    "nameserver": "ns1.example.com",
    "ip": "1.2.3.4",
    "statuses": ["OK"]
  }
}

---

Update nameserver IP

Namecheap: domains.ns.update

POST /domains/:domain/ns/:nameserver

{ "oldIp": "1.2.3.4", "newIp": "5.6.7.8" }

---

Delete a glue nameserver

Namecheap: domains.ns.delete

DELETE /domains/:domain/ns/:nameserver