Skip to content

List CDN zones

GET /api/v2/cdn/zones

Lists the domains on the account that can use the CDN, one entry per registrable domain. Each entry has its status, SSL state, rule count, audience filter and setup state. Each zone you can manage has a CDN zone ID (cdn_…), also before the CDN is set up for it. Use this list to find the zone ID when you only know the domain name.

Subdomains are excluded. They are DNS records inside their parent zone, not zones of their own. Domains in Cancelled, Terminated or TransferredOut state are left out, unless the account also owns a DNS-only zone with the same name. A DNS-only zone has domainId: null.

waf.visitorProfileMode and geoRestriction.combinedCountries are the zone’s saved audience filter. waf and geoRestriction are null when the zone is not active or pending. setup shows how far the CDN setup has come. Only setup.status: active means traffic and HTTPS run through the CDN.

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

Request

Query parameters

limitinteger
Zones per page, 1 to 200. Default 50. Default 50. 1 to 200.
cursorstring
The nextCursor value from the previous page.

Example

GET /api/v2/cdn/zones
curl "https://cloud.hostup.se/api/v2/cdn/zones" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 One page of CDN zones, sorted by domain name.

Response 200
{
"data": [
{
"id": "cdn_01hxa3b4c5d6e7f8g9h0j1k2m3",
"domain": "example.com",
"domainId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"status": "active",
"reason": null,
"proxied": true,
"securityLevel": "medium",
"ssl": {
"status": "active",
"expiresAt": "2027-02-01T00:00:00.000Z"
},
"ruleCount": 2,
"waf": {
"visitorProfileMode": "challenge"
},
"geoRestriction": {
"combinedCountries": [
"SE"
]
},
"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"
}
}
],
"hasMore": false,
"nextCursor": null
}
Response fields
dataarray of object
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 or null
The CDN zone ID (cdn_…). Set even before the CDN is set up. Null only when the zone cannot be identified.
domainstring
domainIdstring or null
The domain ID (dom_…) for a domain registered with Hostup. null for a DNS-only zone.
statusstring
One of active, pending, misconfigured, missing, disabled.
reasonstring or null
proxiedboolean
securityLevelstring
One of off, low, medium, high.
sslobject
statusstring
One of active, pending, error.
expiresAtstring or null
ruleCountinteger
wafobject or null
The saved visitor-profile mode. Null when the settings could not be read.
geoRestrictionobject or null
The countries visitors are limited to now. Countries being set does not mean visitor checks are on. Read waf.visitorProfileMode for that.
hasMoreboolean
nextCursorstring or null

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.
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.