Check where hostnames point
Checks the public DNS of up to 10 hostnames and answers whether each points at the platform, with the records to create. Nothing changes. The person needs the right to change the site.
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.
Body
Up to 10 items.
Returns
200 The state of each hostname.
Fields of the 200 answer
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.
readypendingfailednoneTrue when the hostname is ready.
What to fix, in plain words. Empty when ok is true.
True when every hostname points at the platform.
Format: date-time.
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. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | none | Read the message; it says what happened. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/domains/check \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"hosts": [
"harbourandfinch.example.com",
"www.harbourandfinch.example.com"
]
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/domains/check', [
'hosts' => [
'harbourandfinch.example.com',
'www.harbourandfinch.example.com',
],
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/domains/check', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
hosts: [
'harbourandfinch.example.com',
'www.harbourandfinch.example.com',
],
}),
});
// 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.post(
"https://manage.corefinity.com/api/corestack/sites/1042/domains/check",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"hosts": [
"harbourandfinch.example.com",
"www.harbourandfinch.example.com",
],
},
)
data = res.json() if res.content else None{
"advice": null,
"dns_plan": {
"actions": [
{
"action": "keep",
"existing": null,
"host": "harbourandfinch.example.com",
"reason": null,
"record": {
"content": "203.0.113.10",
"name": "harbourandfinch.example.com",
"proxied": true,
"type": "A"
}
},
{
"action": "manual",
"existing": null,
"host": "shop.harbourandfinch.example.com",
"reason": "Not in a connected Cloudflare zone. Add an A record to 203.0.113.10",
"record": null
}
],
"can_apply": false,
"requires_confirmation": false,
"zone": null
},
"hosts": [
{
"cloudflare_zone": null,
"dns_answers": [
{
"type": "A",
"value": "203.0.113.10"
}
],
"dns_checked_at": "2026-11-06T09:16:05Z",
"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,
"ok": true,
"problems": [],
"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": "198.51.100.9"
}
],
"dns_checked_at": "2026-11-06T09:16:05Z",
"dns_detail": "direct",
"dns_state": "elsewhere",
"dns_state_since": null,
"expected_ip": "203.0.113.10",
"host": "shop.harbourandfinch.example.com",
"noindex": false,
"ok": false,
"problems": [
"Points at 198.51.100.9. Update the A record to 203.0.113.10"
],
"redirects_to": null,
"role": "alias",
"tls": {
"checked_at": null,
"issuer": null,
"not_after": null,
"reason": null,
"state": "none"
}
}
],
"ok": false,
"ran_at": "2026-11-06T09:16:05Z"
}{
"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": "invalid",
"errors": {
"enabled": [
"The enabled field is required."
]
},
"field": "enabled",
"message": "The enabled field is required.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "The DNS check could not run. Try again in a moment."
}