Skip to content

Get a domain's CDN settings

GET /api/v2/domains/{id}/cdn

Get the CDN state and settings for a domain. To list CDN zones for all your domains, including domains registered elsewhere, use GET /api/v2/cdn/zones. setup says how far the CDN setup has come. Branch on setup.status. Copy only the DNS records it returns. When the domain uses other nameservers, you choose how to continue. To move to Hostup’s nameservers, send prepare_nameservers while actions.canPrepareNameservers is allowed. Then change the nameservers to setup.expectedNameservers. To keep your own DNS, send prepare_partial and then check_partial. These setup steps go to POST /api/v2/cdn/zones/{id} with the cdn_… ID from this response’s id, not the domain ID. A prepared setup does not yet mean that traffic and HTTPS work. Change settings with PATCH /api/v2/domains/{id}/cdn. security.blockedCrawlers, waf.uaBlocklist and waf.ipBlocklist are empty unless you set them.

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

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Query parameters

includeRecordsboolean
Include the domain’s A, AAAA and CNAME records in records. Default false. Default false.

Example

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

Responses

200 The domain’s CDN state and settings.

Response 200
{
"id": "cdn_01hxa3b4c5d6e7f8g9h0j1k2m3",
"domain": "example.com",
"state": {
"exists": true,
"enabled": true,
"status": "active",
"reason": null
},
"proxied": true,
"cdn": {
"enabled": true,
"proxy": true
},
"security": {
"level": "medium",
"sslMode": "full",
"alwaysUseHttps": true,
"minTlsVersion": "1.2",
"botProtection": true,
"blockBadCrawlers": true,
"blockBadBots": true,
"wpLoginProtection": true,
"wpAdminChallenge": true,
"blockedCrawlers": []
},
"performance": {
"earlyHints": true,
"alwaysOnline": true
},
"cache": {
"purgeCache": false
},
"waf": {
"skipEnabled": false,
"challengeGeoEnabled": true,
"visitorProfileMode": "challenge",
"ipAllowlist": [
"192.0.2.10"
],
"uaAllowlist": [
"Example-Monitor/1.0"
],
"pathAllowlist": [
"/health"
],
"uaBlocklist": [],
"ipBlocklist": []
},
"geoRestriction": {
"enabled": true,
"whitelistCountries": [
"SE"
],
"mode": "whitelist",
"standardCountries": [],
"additionalCountries": [
"SE"
],
"combinedCountries": [
"SE"
]
},
"activity": {
"lastChangeDetectedAt": "2026-04-27T12:00:00.000Z",
"lastCheckedAt": "2026-04-27T12:00:00.000Z",
"settingsUpdatedAt": "2026-04-27T12:00:00.000Z"
},
"actions": {
"canEnableProxy": {
"allowed": true,
"reason": null
},
"canIssueCertificate": {
"allowed": true,
"reason": null
},
"canChangeMode": {
"allowed": true,
"reason": null
},
"canActivate": {
"allowed": false,
"reason": "CDN is already active for this domain."
},
"canDeactivate": {
"allowed": true,
"reason": null
},
"canPreparePartial": {
"allowed": true,
"reason": null
},
"canCheckPartial": {
"allowed": false,
"reason": "Prepare external DNS setup first."
},
"canPrepareNameservers": {
"allowed": false,
"reason": "Hostup's nameservers already answer for this domain."
}
},
"records": [
{
"id": "drr_01hxa3b4c5d6e7f8g9h0j1k2m3",
"fqdn": "example.com",
"type": "A",
"value": "192.0.2.10",
"proxied": true,
"ttl": 300,
"proxyRule": {
"enabled": true,
"mode": "always"
}
}
],
"setup": {
"mode": "full",
"status": "active",
"reason": null,
"verification": null,
"routing": [],
"certificate": {
"status": "active",
"hosts": [
"example.com",
"www.example.com"
]
},
"checkedAt": "2026-04-27T12:00:00.000Z",
"currentNameservers": [
"primary.ns.hostup.se",
"secondary.ns.hostup.se"
],
"expectedNameservers": [
"primary.ns.hostup.se",
"secondary.ns.hostup.se"
],
"registrarRelation": "hostup",
"nameserverManagementUrl": "/domains/example.com?tab=nameservers"
}
}
Response fields
setupobject
How the CDN is set up for the zone: with Hostup’s nameservers or with your own DNS. Read status and reason as returned. A prepared partial setup is not active until the verification, the routing and the HTTPS certificate are confirmed. Copy the DNS names and values as returned. Don’t build them yourself.
modestring
full: the domain uses Hostup’s nameservers. partial: your own DNS stays authoritative and chosen hostnames are routed through the CDN. currentNameservers shows the nameservers seen now. One of full, partial, unknown.
statusstring
Overall readiness. A pending_… status names the next setup step. unavailable means the state could not be read. It does not mean that DNS or the certificate is wrong. One of not_configured, pending_verification, pending_routing, pending_certificate, active, unavailable.
reasonstring or null
The setup state in words. Null when nothing needs explaining.
verificationobject or null
The TXT record that proves ownership, to publish at your DNS provider. Null when none is needed or available. Copy the name and value exactly.
routingarray of object
The chosen hostnames with the origin values kept when the setup was prepared. Each row has the DNS change it needs at your DNS provider. Publish the routing record without other, conflicting record types at the same name. A row with status: unsupported is not set up.
hostnamestring
currentOriginarray of object
typestring
One of A, AAAA, CNAME.
valuestring
recordobject or null
The exact routing record to publish at your DNS provider. Null when none is available. Use ALIAS only when your provider supports a flattened alias at the zone apex. Don’t replace an apex with a plain CNAME when that conflicts with the other records at the apex.
statusstring
One of pending, verified, unsupported, unknown.
reasonstring or null
certificateobject
statusstring
One of active, pending, error, unknown.
hostsarray of string
Hostnames on the CDN’s HTTPS certificate.
checkedAtstring or null
When the setup was last checked, in UTC. Null when unknown.
currentNameserversarray of string
expectedNameserversarray of string
Hostup’s nameservers, for a full setup. A partial setup does not need them.
registrarRelationstring
Where the registration of the domain is managed. It does not depend on the CDN setup mode. One of hostup, external, unknown.
nameserverManagementUrlstring or null
Link to change the nameservers in the client area, when the domain is registered with Hostup. Otherwise null. To use Hostup’s nameservers then, set expectedNameservers at your registrar.
idstring
The CDN zone ID (cdn_…).
domainstring
stateobject
existsboolean
enabledboolean
statusstring
One of active, inactive, disabled, not_found.
reasonstring or null
proxiedboolean
The main CDN proxy switch for the domain.
cdnobject
enabledboolean
proxyboolean
securityobject
levelstring
Overall CDN security level. One of off, low, medium, high.
sslModestring
The TLS mode between visitors, the CDN and your origin server. One of off, flexible, full, strict.
alwaysUseHttpsboolean
minTlsVersionstring
One of 1.0, 1.1, 1.2, 1.3.
botProtectionboolean
blockBadCrawlersboolean
blockBadBotsboolean
wpLoginProtectionboolean
Protect the WordPress login pages.
wpAdminChallengeboolean
Challenge requests to the WordPress admin paths.
blockedCrawlersarray of string
Crawler catalogue IDs that are blocked before every other rule, verified-bot exemptions included. Examples: baiduspider, gptbot, claudebot, ahrefsbot. Lowercase IDs only. The crawler catalogue has the full list. Empty unless crawlers were chosen. Separate from blockBadCrawlers, the general check for bad crawlers.
performanceobject
earlyHintsboolean
alwaysOnlineboolean
cacheobject
purgeCacheboolean
The saved cache-purge setting.
wafobject
skipEnabledboolean
Whether your own WAF skip rules are on.
challengeGeoEnabledboolean
Whether the country challenge of the visitor profile is on.
visitorProfileModestring
challenge: visitors from outside the allowed countries must pass a challenge. block: they are blocked. off: the visitor profile does nothing. One of off, challenge, block.
ipAllowlistarray of string
IP addresses or CIDR ranges that skip the custom WAF checks.
uaAllowlistarray of string
User-agent substrings that skip the custom WAF checks.
pathAllowlistarray of string
Path prefixes that skip the custom WAF checks.
uaBlocklistarray of string
User-agent substrings that are blocked before every allowlist and verified-bot exemption. Entries equal to or contained in ordinary browser tokens, such as Mozilla, Chrome or bot, are rejected with invalid_request. They would block ordinary visitors.
ipBlocklistarray of string
IPv4 or IPv6 addresses or CIDR ranges that are blocked before every allowlist and verified-bot exemption.
geoRestrictionobject
enabledboolean
whitelistCountriesarray of string
Older field with the allowed country codes, in capitals. Use combinedCountries instead.
modestring
off: no country limit. whitelist: only the countries in combinedCountries are allowed. One of off, whitelist.
standardCountriesarray of string
Countries that are always allowed. You cannot remove them.
additionalCountriesarray of string
Country codes you added on top of standardCountries.
combinedCountriesarray of string
The allowed countries: standardCountries plus additionalCountries.
activityobject
lastChangeDetectedAtstring or null
lastCheckedAtstring or null
settingsUpdatedAtstring or null
actionsobject
canEnableProxyobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canIssueCertificateobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canChangeModeobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canActivateobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canDeactivateobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canPreparePartialobject
Whether you can prepare a setup with your own DNS. The request also checks the current delegation. A full setup that is delegated now cannot be converted with this action.
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canCheckPartialobject
Whether an existing partial setup can be checked now.
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canPrepareNameserversobject
Whether the zone still has to be published on Hostup’s nameservers before you switch the domain to them. Allowed while it is not published there. Then send prepare_nameservers to POST /api/v2/cdn/zones/{id}. Read the zone until this gate closes. Only then change the nameservers. Not allowed when the zone is already published, when it uses your own DNS or when readiness was not checked.
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
recordsarray of any or null
null unless you send includeRecords=true. Then the proxied A, AAAA and CNAME records.

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.
409Conflict. code is account_suspended.
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.
502Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists.