Realtime Register - Get domain zone information

Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Used to get the zone attached to a domain

GETMethod
/v2/domains/domainName/zoneURL

Name	Type	Description	Restrictions
domainName	String	The domain name	Regular expression: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$ Minimum length: 3 Maximum length: 255 Registry specific restrictions may apply

Successful request

200 OKHTTP Status
application/jsonContent-Type

Name	Type	Required / Optional	Description
template	String	Optional	Name of the template the zone is linked to
hostMaster	String	Required	The email address of the hostmaster
refresh	Integer	Required	The time when the slave will try to refresh the zone from the master, in seconds
retry	Integer	Required	The time between retries if the slave (secondary) fails to contact the master when refresh has expired, in seconds
expire	Integer	Required	Indicates when the zone data is no longer authoritative, in seconds
ttl	Integer	Required	The duration that the record may be cached, in seconds
defaultRecords	List < defaultRecords >	Required	Default DNS records
records	List < records >	Optional	DNS records

Name	Type	Required / Optional	Description
name	String	Required	The record name. ##DOMAIN## will be replaced by the domain name to which this template will be applied
type	Enum	Required	The record type Possible values: A: Address record MX: Mail exchange record CNAME: Canonical name record AAAA: IPv6 address record URL: URL Record MBOXFW: Mailbox forward record HINFO: Host information record NAPTR: Naming Authority Pointer NS: Name server record SRV: Service locator CAA: Certification Authority Authorization TLSA: Transport Layer Security Authentication ALIAS: ALIAS record TXT: Text record SOA: Start of [a zone of] authority record
content	String	Required	Type specific content of the record
ttl	Integer	Required	The duration that the record may be cached, in seconds
prio	Integer	Optional	The priority, mandatory if "type" is MX or SRV

Name	Type	Required / Optional	Description
name	String	Required	The record name. ##DOMAIN## will be replaced by the domain name to which this template will be applied
type	Enum	Required	The record type Possible values: A: Address record MX: Mail exchange record CNAME: Canonical name record AAAA: IPv6 address record URL: URL Record MBOXFW: Mailbox forward record HINFO: Host information record NAPTR: Naming Authority Pointer NS: Name server record SRV: Service locator CAA: Certification Authority Authorization TLSA: Transport Layer Security Authentication ALIAS: ALIAS record TXT: Text record SOA: Start of [a zone of] authority record
content	String	Required	Type specific content of the record
ttl	Integer	Required	The duration that the record may be cached, in seconds
prio	Integer	Optional	The priority, mandatory if "type" is MX or SRV

Failed requests

Generic errors can be expected.

GET /v2/domains/domainName/zone