CorefinityCorefinityDocs
Open the Control PanelControl Panel
Domains · 5 of 8

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.

POST/api/corestack/sites/{site}/domains/check

Path parameters

siteintegerRequired

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

hostsarray of stringsRequired

Up to 10 items.

Returns

200 The state of each hostname.

Fields of the 200 answer
adviceobject or any or nullRequired
dns_planobject or any or nullRequired
hostsarray of objectsRequired
Fields of each item
cloudflare_zoneobject or nullRequired

The connected Cloudflare zone the hostname is in, with its id and name. proxied and record_id are sent as null.

dns_answersarray of objects or nullRequired
Fields of each item
typestring
valuestring
dns_checked_atstring or nullRequired

Format: date-time.

dns_detailstring or nullRequired
dns_statestringRequired
points_hereproxied_hereelsewhereunresolvedunknown
dns_state_sincestring or nullRequired
expected_ipstring or nullRequired

The address the hostname must point at.

hoststringRequired
noindexboolean

True when search engines are asked not to index this hostname. Not sent in the answer of POST …/domains/point-dns.

redirects_tostring or nullRequired

The hostname this one redirects to. Null when it serves the site itself.

rolestringRequired
primaryaliaspreviewlegacystore
servestring

Sent for extra domains on Shopware, and on Magento 2 while Magento store domains are available.

redirectstorefront
storeobject

A Magento storefront alias's store choice, or the selected choice on the primary. An unmapped alias shows the default store.

Fields
codestring or nullRequired
namestring or nullRequired
previousobject or any or null

While pending, the store losing this host; null for a new storefront. Omitted otherwise.

statestringRequired
mappedpendingunmapped
typestring or nullRequired
websitestorenull
tlsobject or nullRequired

The certificate for the hostname.

Fields
checked_atstring or null

Format: date-time.

issuerstring or null
not_afterstring or null
reasonstring or null
statestring
readypendingfailednone
okbooleanRequired

True when the hostname is ready.

problemsarray of stringsRequired

What to fix, in plain words. Empty when ok is true.

okbooleanRequired

True when every hostname points at the platform.

ran_atstringRequired

Format: date-time.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409deletedThe 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.
409provisioningThe site is still being created. Try again in a few minutes.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
502noneRead 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"
    ]
  }'
{
  "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"
}
Try it
Held in this tab's memory only. Never stored or sent to us.

This sends a real POST request and changes your account.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT