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

Used to get a template

  • GETMethod
  • /v2/customers/customer/dnstemplates/templateURL
Name Type Description Restrictions
customer String The handle of the customer
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
template String The template name
  • Minimum length: 3
  • Maximum length: 40
Name Type Required / Optional Description Restrictions
fields String Optional Select fields to include in the response, comma separated list of field names. Requesting only the needed fields improves response time, especially when omitting relation fields. Identifying field(s) are always included.

Successful request

  • 200 OKHTTP Status
  • application/jsonContent-Type
Name Type Required / Optional Description
name String Optional Name of the template
createdDate Timestamp Required The date the template was created
updatedDate Timestamp Optional The date the template was last updated
customer String Required The customer handle
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
  • DNSKEY: DNSKEY record
  • CERT: Certificate record
  • DS: DS record
  • LOC: Location record
  • SSHFP: SSH key record
  • URI: URI 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
  • DNSKEY: DNSKEY record
  • CERT: Certificate record
  • DS: DS record
  • LOC: Location record
  • SSHFP: SSH key record
  • URI: URI 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.

The handle of the customer
The template name
Select fields to include in the response, comma separated list of field names. Requesting only the needed fields improves response time, especially when omitting relation fields. Identifying field(s) are always included.

GET /v2/customers/customer/dnstemplates/template