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
limitinteger50. 1 to 200.cursorstringnextCursor value from the previous page.Example
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.
{ "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 objectsetupobjectstatus 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.modestringfull: 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.statusstringpending_… 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 nullverificationobject or nullroutingarray of objectstatus: unsupported is not set up.hostnamestringcurrentOriginarray of objecttypestringA, AAAA, CNAME.valuestringrecordobject or nullALIAS 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.statusstringpending, verified, unsupported, unknown.reasonstring or nullcertificateobjectstatusstringactive, pending, error, unknown.hostsarray of stringcheckedAtstring or nullcurrentNameserversarray of stringexpectedNameserversarray of stringregistrarRelationstringhostup, external, unknown.nameserverManagementUrlstring or nullexpectedNameservers at your registrar.idstring or nullcdn_…). Set even before the CDN is set up. Null only when the zone cannot be identified.domainstringdomainIdstring or nulldom_…) for a domain registered with Hostup. null for a DNS-only zone.statusstringactive, pending, misconfigured, missing, disabled.reasonstring or nullproxiedbooleansecurityLevelstringoff, low, medium, high.sslobjectstatusstringactive, pending, error.expiresAtstring or nullruleCountintegerwafobject or nullgeoRestrictionobject or nullwaf.visitorProfileMode for that.hasMorebooleannextCursorstring or nullErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |
| 502 | Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists. |