Skip to content

Schemas

These models describe how API requests and responses are shaped. Each one is linked from the endpoints that use it.

SchemaDescriptionEndpoints
A
AAAA
ALIAS
authinfoResponse1
baseResult39
CAA
CNAME
csrPEM encoded certificate signing request (CSR).
dnssecCapabilities
dnssecDisplayStateHigh-level DNSSEC status.
dnssecJobResponse1
dnssecModeRequested DNSSEC operating mode. none: no registry DNSSEC should remain active; regfish: regfish signs the zone and manages registry trust anchors; external: the caller supplies DNSSEC records for external authoritative nameservers
dnssecRecord
dnssecRecordKind
dnssecRequest1
dnssecResponse4
dnssecStateFine-grained registry DNSSEC state.
dnsZoneCounts
dnsZoneDelegationNameserver
dnsZoneDetailResponse1
dnsZoneRecordResponseSuperset record representation returned by the detailed zone endpoint. Record-specific fields such as priority, flags, or tag are included when applicable.
dnsZoneSOA
dnsZoneSummaryResponse1
domain_name_checkableA domain name to check. Unlike fqdn_relaxed this also accepts internationalised names (e.g. müller-shop.de); they are converted to punycode and validated against the public suffix list server-side.1
domainAvailabilityResponse1
domainDetailsResponse1
domainListFilter
domainListResponse1
domainListSortKey1
domainResponse
Error172
fqdnFully Qualified Domain Name (FQDN, ending with a period).
fqdn_or_subdomainFully Qualified Domain Name (FQDN) or subdomain. You can use the @ symbol to represent your apex domain (e.g., example.com). Wildcards are supported.
fqdn_relaxedFully Qualified Domain Name.12
helpSearchResponse1
HINFOStored
hostingAlias1
hostingDatabase1
hostingPackage2
ipv4
ipv6
MX
nameserversResponse2
nameserversUpdateRequest1
NAPTRStored
NSStored
prepareOrderPosition
prepareOrderRequest1
prepareOrderResponse1
PTRStored
record
recordRequest1
recordRequestFQDN2
recordResponse5
recordResponseAdditionalReqFQDN
recordResponseAdditionalReqRRID
recordResponseAdditionalState
recordStoredA record of a type the API returns as stored but does not create or update (managed in the dash). data is the raw record data. Apex NS records are not part of the record list; see the nameserver endpoints.
recordType
recordTypeStored
RPStored
rridResource Record ID3
sortOrder1
SRVService record (RFC 2782). The name carries the service and protocol labels (_imaps._tcp.example.com), data is the target host as an FQDN ending with a period. Clients try the lowest priority first and spread load by weight among records of the same priority.
TLSATLSA record (DANE, RFC 6698 and RFC 7672). The name carries the port and protocol labels (_25._tcp.mail.example.com), data is the certificate association data as hexadecimal digits (blanks allowed, case ignored). The record is stored as usage selector matching_type data, the hex in lower case without blanks. The data must have the length of the chosen hash: 64 hex digits for SHA-256 (matching type 1), 128 for SHA-512 (matching type 2). Matching type 0 (full data) is accepted up to a stored length of 250 characters; use a hash for anything longer.
tlsCertificateCancelRequest1
tlsCertificateCompleteRequest1
tlsCertificateDcvMethod
tlsCertificateDownloadFormat1
tlsCertificateIdPublic TLS certificate ID7
tlsCertificateOrderCancellationMode
tlsCertificateOrderCancelRequest1
tlsCertificateOrganization
tlsCertificateProductregfish TLS certificate product identifier.
tlsCertificateProvider
tlsCertificateReissueRequest1
tlsCertificateReissueResponse
tlsCertificateReissueStatus
tlsCertificateRequest1
tlsCertificateResponse8
tlsCertificateRevocationReasonRevocation reason.
tlsCertificateRevocationScope
tlsCertificateRevokeRequest1
tlsCertificateStatus
tlsOrganizationCreateRequest1
tlsOrganizationIdPublic TLS organization ID2
tlsOrganizationPatchRequest1
tlsOrganizationResponse4
tlsOrganizationStatus
tlsProductAuthority
tlsProductResponse1
tlsProductSpecs
tlsProductValidationLevel
tlsProductValidationType
tlsValidation
tlsValidationDnsRecord
tokenInfoResponse1
ttlTime To Live in seconds (60-86400)
TXT
type