Get a site's domains
Answers the main domain, the extra domains, each hostname's DNS and certificate state, and the version to send with a save.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Returns
200 The site's domains.
Fields of the 200 answer
Whether a saved set of rules is live on the site.
Fields
Sent only by the sets that have more to say, such as HTTP authentication.
The change that is applying the set, while one is running.
Such as applied or applying.
Whether your company's Cloudflare is connected, and the zone the main domain is in.
Fields
Fields of each item
The connected Cloudflare zone the hostname is in, with its id and name. proxied and record_id are sent as null.
Fields of each item
Format: date-time.
points_hereproxied_hereelsewhereunresolvedunknownThe address the hostname must point at.
True when search engines are asked not to index this hostname. Not sent in the answer of POST …/domains/point-dns.
The hostname this one redirects to. Null when it serves the site itself.
primaryaliaspreviewlegacystoreSent for extra domains on Shopware, and on Magento 2 while Magento store domains are available.
redirectstorefrontA Magento storefront alias's store choice, or the selected choice on the primary. An unmapped alias shows the default store.
Fields
While pending, the store losing this host; null for a new storefront. Omitted otherwise.
mappedpendingunmappedwebsitestorenullThe certificate for the hostname.
Fields
Format: date-time.
readypendingfailednoneThe address the site's domains must point at.
Fields
The most hostnames a site can have, the main domain included.
Why the domains cannot be changed. Null when they can.
production once a domain is attached, staging before.
productionstagingTrue when search engines are asked not to index the site.
roleflagsnoneThe main domain. Null until a domain is attached.
Fields
Whether the main domain can be changed now, and why not.
Fields
The main domain change that is running, if one is.
Send this with a save. It changes whenever the domains change. At least 0.
Whether the main domain is its www or its bare form.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | deleted | The site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored. |
409 | provisioning | The site is still being created. Try again in a few minutes. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/domains \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/domains');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/domains', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/sites/1042/domains",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"advice": null,
"apply": {
"applied_at": "2026-11-02T14:37:55Z",
"error": null,
"operation": null,
"state": "applied",
"state_label": "Applied"
},
"canonical_url": "https://harbourandfinch.example.com",
"cloudflare": {
"connected": false,
"zone": null
},
"hosts": [
{
"cloudflare_zone": null,
"dns_answers": [
{
"type": "A",
"value": "203.0.113.10"
}
],
"dns_checked_at": "2026-11-06T09:00:12Z",
"dns_detail": null,
"dns_state": "points_here",
"dns_state_since": "2026-11-01T10:14:03Z",
"expected_ip": "203.0.113.10",
"host": "harbourandfinch.example.com",
"noindex": false,
"redirects_to": null,
"role": "primary",
"tls": {
"checked_at": "2026-11-06T09:14:41Z",
"issuer": "Let's Encrypt",
"not_after": "2026-12-08T05:41:17Z",
"reason": null,
"state": "ready"
}
},
{
"cloudflare_zone": null,
"dns_answers": [
{
"type": "A",
"value": "203.0.113.10"
}
],
"dns_checked_at": "2026-11-06T09:00:12Z",
"dns_detail": null,
"dns_state": "points_here",
"dns_state_since": "2026-11-01T10:14:03Z",
"expected_ip": "203.0.113.10",
"host": "www.harbourandfinch.example.com",
"noindex": false,
"redirects_to": "harbourandfinch.example.com",
"role": "alias",
"tls": {
"checked_at": "2026-11-06T09:14:41Z",
"issuer": "Let's Encrypt",
"not_after": "2026-12-08T05:41:17Z",
"reason": null,
"state": "ready"
}
}
],
"ingress_ip": "203.0.113.10",
"limits": {
"hosts_max": 10
},
"locked_reason": null,
"mode": "production",
"noindex": false,
"noindex_source": "flags",
"primary": "harbourandfinch.example.com",
"url_change": {
"can_change": {
"available": true,
"reason": null
},
"in_flight": null
},
"version": 4,
"www": "bare"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "deleted",
"message": "This site is deleted and waiting to be purged. Restore it first.",
"reason": "deleted"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}