Skip to content

Get automatic DNSSEC status

GET /api/v2/domains/{id}/dnssec-auto

Returns the state of automatic DNSSEC for the domain. Automatic DNSSEC works for domains on the Hostup nameservers primary.ns.hostup.se and secondary.ns.hostup.se. It checks the zone’s DNSSEC keys and publishes the DS record at the registry. No manual DS/KEY records are needed. A nameserver change pauses it for a 72-hour cooldown. While paused, status is blocked and blockedUntil says when it resumes. Before a nameserver change, dnssecAutoWillBeBlocked on GET /api/v2/domains/{id}/nameservers says whether the change would start the cooldown. A status of error is still a 200 response. reason and lastError explain it.

Authentication: An API key with the scope read:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Example

GET /api/v2/domains/{id}/dnssec-auto
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dnssec-auto" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 The automatic DNSSEC state.

Response 200
{
"domainName": "example.se",
"status": "blocked",
"reason": "Nameservers changed recently; automatic DNSSEC is paused until the cooldown period ends.",
"isEnabled": true,
"isBlocked": true,
"blockedUntil": "2026-04-29T09:30:00.000Z",
"blockReason": "Nameservers changed recently; automatic DNSSEC is paused until the cooldown period ends.",
"lastCheckedAt": "2026-04-27T12:00:00.000Z",
"lastError": null,
"nameserversChangedAt": "2026-04-26T09:30:00.000Z"
}
Response fields
domainNamestring | null
The domain name.
statusstring
active (on and working), pending (waiting for the zone’s DNSSEC records to be detected), blocked (paused during the cooldown after a nameserver change), excluded (turned off for this domain), inactive (not active for this domain) or error (the last attempt failed). One of active, inactive, excluded, pending, error, blocked.
reasonstring | null
A readable explanation of status.
isEnabledboolean
True when status is active, pending or blocked.
isBlockedboolean
True while the cooldown after a nameserver change is running.
blockedUntilstring | null
When the cooldown ends. Null when not blocked.
blockReasonstring | null
Why automatic DNSSEC is paused. Null when not blocked.
lastCheckedAtstring | null
When automatic DNSSEC last checked the domain.
lastErrorstring | null
The error from the last failed attempt.
nameserversChangedAtstring | null
When the nameservers last changed.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.