Skip to main content
GET
/
core
/
v1
/
domains
/
{domainName}
/
vanity_nameservers
List Vanity Nameservers
curl --request GET \
  --url https://api.dev.name.com/core/v1/domains/{domainName}/vanity_nameservers \
  --header 'Authorization: Basic <encoded-value>'
{
  "lastPage": 5,
  "nextPage": 2,
  "vanityNameservers": []
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Path Parameters

​
domainName
string<hostname>
required

The domain name to list vanity nameservers for.

Example:

"example.com"

Query Parameters

​
perPage
integer
default:1000

The number of records to return per page. Defaults to 1000.

Required range: x >= 1
Example:

50

​
page
integer
default:1

The page number to return.

Required range: x >= 1
Example:

2

Response

List of vanity nameservers.

ListVanityNameserversResponse returns the list of vanity nameservers for the domain.

​
vanityNameservers
object[]
required

VanityNameservers is the list of vanity nameservers associated with the domain. If no vanity nameservers are configured, this will be an empty array.

Example:
[]
​
lastPage
integer | null

LastPage is the identifier for the final page of results. It is only populated if there is another page of results after the current page. If no further pages exist, this field will be null.

Required range: x >= 1
Example:

5

​
nextPage
integer | null

NextPage is the identifier for the next page of results. It is only populated if there is another page of results after the current page. If no further pages exist, this field will be null.

Required range: x >= 1
Example:

2

⌘I