# Nameservers

## query-ns-list

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Accepts:**</span>

<table border="1" id="bkmrk-pattern-pattern-to-m" style="width: 80%;"><tbody><tr><td>*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">pattern</span>*</td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">pattern to match (against host name, like "ns.dom\*")</span></td></tr><tr><td>*<span style="font-size: small;">full</span>*

</td><td><span style="font-size: small;">include IPs if non-zero (0 or 1)</span>

</td></tr></tbody></table>

**<span style="font-size: small;"> </span><span style="font-size: small;">Returns:</span>**

<span style="font-size: small;">List of registered name servers, one per line.</span>

<span style="font-size: small;"> If "full" is non-zero, then the list will include IP addresses, IPv4 (2nd column) and IPv6 (3rd column).</span>

<span style="font-size: small;">Columns will be separated by tab ("\\t") character. If specific IP is not present (say, there is only IPv4 or IPv6), it will be listed as "-". </span>

<span style="font-size: small;"> </span><span style="font-size: small;">Example of list with IPs: </span>

<div id="bkmrk-1-2-ns.example.com-1"><div class="syntaxhighlighter  plain" id="bkmrk-1-2-ns.example.com-1-1"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="gutter"><div class="line number1 index0 alt2">1</div><div class="line number2 index1 alt1">2</div></td><td class="code"><div class="container"><div class="line number1 index0 alt2">`ns.example.com 1.2.3.4 - `</div><div class="line number2 index1 alt1">`ns6.example.com - FE80:0000:0000:0000:0202:B3FF:FE1E:8329`</div></div></td></tr></tbody></table>

</div></div><span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Example:**</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">`<span style="font-size: small; font-family: courier new,courier;">  https://dmapi.joker.com/request/query-ns-list?pattern=*my-own-ns*&full=1&auth-sid=<your-current-session-id></span>`</span>

## ns-create

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Requires:**</span>

<table border="1" id="bkmrk-host-full-qualified-" style="width: 80%;"><tbody><tr><td style="width: 50.2084%;">*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">host</span>*</td><td style="width: 49.9108%;"><span style="font-family: arial,helvetica,sans-serif; font-size: small;">Full qualified host name</span></td></tr><tr><td style="width: 50.2084%;">*<span style="font-size: small;"><span style="font-family: arial,helvetica,sans-serif;">ip</span></span>*</td><td style="width: 49.9108%;"><span style="font-family: arial,helvetica,sans-serif; font-size: small;">IPv4 address (must not be from IANA's reserved range)</span>

</td></tr><tr><td style="width: 50.2084%;">*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">ipv6</span>*</td><td style="width: 49.9108%;"><span style="font-family: arial,helvetica,sans-serif; font-size: small;">IPv6 address (short notation like fec0::17 is accepted)</span></td></tr></tbody></table>

  
<span style="font-family: arial,helvetica,sans-serif; font-size: small;">With this request a new nameserver can be registered with the registry. This is needed to use a nameserver with glue records.</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">Either an IPv4 or IPv6 address is required.</span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">Multiple IPs could be specified using "," (comma) as a separator, like "ip=1.2.3.4,4.5.6.7"</span>

## ns-modify or host-modify

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Requires:**</span>

<table border="1" id="bkmrk-host-full-qualified--1" style="width: 80%;"><tbody><tr><td>*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">host</span>*</td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">full qualified host name</span></td></tr><tr><td>*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">ip</span>*</td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;">IPv4 address (must not be from IANA's reserved range)</span>

</td></tr><tr><td>*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">ipv6</span>*</td><td><span style="font-family: arial,helvetica,sans-serif;"><span style="font-size: small;">IPv6 address (short notation </span></span><span style="font-family: arial,helvetica,sans-serif; font-size: small;">like 'fec0::17' </span><span style="font-family: arial,helvetica,sans-serif;"><span style="font-size: small;">is accepted)</span></span></td></tr></tbody></table>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">With this request you can modify the IP address of a registered nameserver. </span>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">Multiple IPs could be specified using "," (comma) as a separator, like "ip=1.2.3.4,4.5.6.7"</span>

## ns-delete or host-delete

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">**Requires:**</span>

<table border="1" id="bkmrk-host-full-qualified--2" style="width: 80%;"><tbody><tr><td>*<span style="font-family: arial,helvetica,sans-serif; font-size: small;">host </span>*</td><td><span style="font-family: arial,helvetica,sans-serif; font-size: small;"> Full qualified host name </span></td></tr></tbody></table>

<span style="font-family: arial,helvetica,sans-serif; font-size: small;">With this request you can delete a registered nameserver.</span>