Skip to content

Compare current and previous website origins

GET /api/v2/domains/{id}/dns/diagnostics/origin-compare

Checks which server answers HTTPS for a host on the domain. The call resolves the host in public DNS and fetches the site from that address. It also fetches the site from each A and AAAA record the domain’s DNS zone has for the host, from the Hostup web hosting server the domain is attached to and from the addresses in the latest DNS snapshot taken before the domain moved to Hostup. Use it when a site fails, shows old content or works only some of the time after a DNS or nameserver change. diagnosis sums up what the results point to. Its evidence lists the result for each address. Up to 12 addresses from the DNS zone are fetched. Any address that was skipped is named in diagnosis.evidence.

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

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Query parameters

hoststring
The host to check: the domain itself or a subdomain such as www.example.se. Default: the domain itself.

Example

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

Responses

200 The public answer, the Hostup origin, the previous origins and a diagnosis.

Response 200
{
"host": "example.se",
"asciiHost": "example.se",
"checkedAt": "2026-05-19T10:30:00.000Z",
"currentPublic": {
"a": [
"198.51.100.20",
"198.51.100.21"
],
"aaaa": [],
"cname": [],
"probedIp": "198.51.100.20",
"appearsCdnEdge": true,
"edgeProvider": "cloudflare",
"httpStatus": 404,
"server": "cloudflare",
"bodyBytes": 1251,
"title": "404 Not Found",
"responseMs": 188,
"errorReason": null
},
"hostupOrigin": {
"ip": "192.0.2.10",
"recordName": "@",
"recordType": "A",
"target": null,
"source": "current_hostup_dns_record",
"httpStatus": 404,
"server": "LiteSpeed",
"bodyBytes": 1251,
"title": "404 Not Found",
"responseMs": 142,
"errorReason": null
},
"hostupOriginReason": null,
"previousOrigins": [
{
"ip": "198.51.100.40",
"recordName": "@",
"recordType": "A",
"target": null,
"source": "pre_nameserver_change",
"snapshotId": "dnss_01hxa3b4c5d6e7f8g9h0j1k2m3",
"capturedAt": "2026-05-19T09:55:00.000Z",
"providerHint": "ns1.old-provider.example (198.51.100.53)",
"httpStatus": 200,
"server": "nginx",
"bodyBytes": 56057,
"title": "Example website",
"responseMs": 210,
"errorReason": null
}
],
"previousOriginsReason": null,
"diagnosis": {
"summary": "Public DNS appears to use a CDN edge, but the stronger signal is that the HostUp origin returns 404 while a previous origin still returns a working site.",
"confidence": "high",
"evidence": [
"Current public HTTPS via 198.51.100.20 returned HTTP 404 with title \"404 Not Found\".",
"Current public HTTPS response appears to be served through cloudflare.",
"Current managed-zone A origin 192.0.2.10 (HostUp) returned HTTP 404.",
"Previous origin 198.51.100.40 returned HTTP 200."
]
}
}
Response fields
hoststring
The host that was checked.
asciiHoststring
The host in ASCII (punycode) form.
checkedAtstring
When the check ran.
currentPublicobject
What public DNS answers for the host and how that address responded over HTTPS.
aarray of string
A record values in public DNS.
aaaaarray of string
AAAA record values in public DNS.
cnamearray of string
CNAME targets in public DNS.
probedIpstring or null
The public address that was fetched. Null when public DNS has no A or AAAA record.
appearsCdnEdgeboolean
True when the response came through a CDN.
edgeProviderstring or null
The CDN detected from the response, such as cloudflare.
httpStatusinteger or null
HTTP status of the response. Null when no response came back.
serverstring or null
The Server header of the response.
bodyBytesinteger
Bytes of the response body that were read.
titlestring or null
The HTML title of the page.
responseMsinteger
Response time in milliseconds.
errorReasonstring or null
Why the fetch failed. Null when a response came back.
hostupOriginnull
The Hostup web hosting server for this host and how it responded. Null when none was found.
hostupOriginReasonstring or null
Why hostupOrigin is null.
previousOriginsarray of object
Up to 6 addresses from the latest DNS snapshot taken before the move to Hostup, with how each one responded.
ipstring
recordNamestring or null
recordTypestring
One of A, AAAA, CNAME, ALIAS.
targetstring or null
The CNAME or ALIAS target, when the IP came from following an alias.
sourcestring
Where this origin came from. For example current_hostup_dns_record (the current record at Hostup) or a DNS snapshot source such as pre_nameserver_change.
snapshotIdstring
The snapshot ID (dnss_…), when this origin came from DNS history.
capturedAtstring
When the snapshot was taken, when this origin came from DNS history.
providerHintstring or null
The DNS provider at the time of the snapshot, usually its old nameserver.
httpStatusinteger or null
serverstring or null
bodyBytesinteger
titlestring or null
responseMsinteger
errorReasonstring or null
previousOriginsReasonstring or null
Why previousOrigins is empty.
diagnosisobject
What the results point to.
summarystring
The conclusion in a few sentences.
confidencestring
How certain the conclusion is. One of high, medium, low.
evidencearray of string
The observations behind the conclusion.

Errors

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

400host is not a valid host name on this domain.
401Unauthorized. Authentication is required.
403Forbidden. The API key lacks a required scope or covers only some DNS records. This call reads the whole DNS zone and needs access to all of it.
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.