NetBird Full API Reference + Read-Only MCP Prototype
GET/api/dns/nameservers

List nameserver groups

Lists all nameserver groups configured for DNS. Use this operation to inspect group names, nameservers, and associated settings.

5 status codes
200Returns an array of nameserver group objects, including their identifiers and configuration fields.
idstringrequired
Nameserver group ID
descriptionstringrequired
Description of the nameserver group
domainsarray<string>required
Match domain list. It should be empty only if primary is true.
enabledbooleanrequired
Nameserver group status
groupsarray<string>required
Distribution group IDs that defines group of peers that will use this nameserver group
namestringrequired
Name of nameserver group name
nameserversarray<object>required
Nameserver list
primarybooleanrequired
Defines if a nameserver group is primary that resolves all domains. It should be true only if domains list is empty.
search_domains_enabledbooleanrequired
Search domain status for match domains. It should be true only if domains list is not empty.
400Returned when the request is invalid.
401Returned when authentication is required but missing or invalid.
403Returned when the request is forbidden.
500Returned when an internal server error occurs.

Error handling

A 400 is returned when the request is invalid. A 401 is returned when authentication is missing or invalid; send valid credentials in the Authorization header. A 403 indicates insufficient permission, and a 500 indicates an internal server error.