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

List DNS zones

Lists all custom DNS zones. Use this operation to inspect zone names, domains, distribution groups, and associated records.

4 status codes
200Returns an array of DNS zone objects, including their identifiers, names, domains, distribution groups, settings, and records.
idstringrequired
Zone ID
recordsarray<object>required
DNS records associated with this zone
distribution_groupsarray<string>required
Group IDs that defines groups of peers that will resolve this zone
domainstringrequired
Zone domain (FQDN)
enable_search_domainbooleanrequired
Enable this zone as a search domain
enabledbooleanrequired
Zone status
Default:true
namestringrequired
Zone name identifier
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 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.