--- title: Get Account Custom Nameserver Related Zone Metadata --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Zones](https://developers.cloudflare.com/api/go/resources/zones) [Custom Nameservers](https://developers.cloudflare.com/api/go/resources/zones/subresources/custom_nameservers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Account Custom Nameserver Related Zone Metadata Deprecated: Use \[DNS settings API](https://developers.cloudflare.com/api/resources/dns/subresources/settings/methods/get/) instead. client.Zones.CustomNameservers.Get(ctx, query) (\*[CustomNameserverGetResponse](), error) GET/zones/{zone\_id}/custom\_ns Get metadata for account-level custom nameservers on a zone. Deprecated in favor of [Show DNS Settings](https://developers.cloudflare.com/api/operations/dns-settings-for-a-zone-list-dns-settings). ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Trust and Safety Write``Trust and Safety Read``Zero Trust: PII Read``Zaraz Edit``Zaraz Read``Zaraz Admin``Access: Apps and Policies Revoke``Access: Apps and Policies Write``Access: Apps and Policies Read``Access: Apps and Policies Revoke``Access: Mutual TLS Certificates Write``Access: Organizations, Identity Providers, and Groups Write``Zone Settings Write``Zone Settings Read``Zone Read``DNS Read``Workers Scripts Write``Workers Scripts Read``Zone Write``Workers Routes Write``Workers Routes Read``Stream Write``Stream Read``SSL and Certificates Write``SSL and Certificates Read``Logs Write``Logs Read``Cache Purge``Page Rules Write``Page Rules Read``Load Balancers Write``Load Balancers Read``Firewall Services Write``Firewall Services Read``DNS Write``Apps Write``Analytics Read``Access: Apps and Policies Write``Access: Apps and Policies Read` ##### ParametersExpand Collapse
query CustomNameserverGetParams ZoneID param.Field\[string] Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20zones.custom_nameservers%20%3E%20(method)%20get%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type CustomNameserverGetResponse struct{…}
Errors \[]CustomNameserverGetResponseError Code int64 minimum1000 Link to this property Message string Link to this property DocumentationURL stringOptional Link to this property
Source CustomNameserverGetResponseErrorsSourceOptional Pointer stringOptional Link to this property
Link to this property
Link to this property
Messages \[]CustomNameserverGetResponseMessage Code int64 minimum1000 Link to this property Message string Link to this property DocumentationURL stringOptional Link to this property
Source CustomNameserverGetResponseMessagesSourceOptional Pointer stringOptional Link to this property
Link to this property
Link to this property Success CustomNameserverGetResponseSuccess Whether the API call was successful. Link to this property Enabled boolOptional Whether zone uses account-level custom nameservers. Link to this property NSSet float64Optional The number of the name server set to assign to the zone. maximum5 minimum1 Link to this property
ResultInfo CustomNameserverGetResponseResultInfoOptional Count float64Optional Total number of results for the requested service. Link to this property Page float64Optional Current page within paginated list of results. Link to this property PerPage float64Optional Number of results per page of results. Link to this property TotalCount float64Optional Total results available without any search parameters. Link to this property TotalPages float64Optional The number of total pages in the entire result set. Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.custom_nameservers%20%3E%20(model)%20CustomNameserverGetResponse%20%3E%20(schema)>) ### Get Account Custom Nameserver Related Zone Metadata Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/zones" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) customNameserver, err := client.Zones.CustomNameservers.Get(context.TODO(), zones.CustomNameserverGetParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", customNameserver.Errors) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "enabled": true, "ns_set": 1, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "enabled": true, "ns_set": 1, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```