Get custom domain status

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Asks the hosting provider whether the domain's DNS is verified, and returns the domain with the answer written into it.

This is the endpoint to poll while waiting for a domain to go live. It reaches the provider on every call, unlike Get custom domain, which returns Base44's stored copy. It also writes what it learns, so last_status_check and last_status_payload on the domain are updated as a side effect.

Only call this for a domain that's currently linked. A domain that was never linked, or was unlinked, isn't attached at the provider, and asking about it fails rather than reporting "not verified".

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

post/api/apps/{app_id}/custom-domains/{domain_id}/status

Path parameters

app_idstring required

ID of the app the domain belongs to.

domain_idstring required

ID of the custom domain. Get this from List custom domains.

Response

The domain, with the provider's answer written into its status fields.

idstring required

ID of the domain. Pass it as domain_id to the other domain endpoints.

domainstring required

The domain name, normalized to lower case with any scheme, trailing slash and leading www. removed.

app_idstring required

ID of the app the domain serves.

disabledboolean required

Whether Base44 has stopped serving the domain. A disabled domain stays attached to the app and keeps its DNS, and serves a placeholder page instead of the app.

last_status_checkstring date-time nullable

When Get custom domain status last ran for this domain, as a UTC timestamp in ISO 8601 format, or null if it never has.

redirect_target_domainstring nullable

The domain that visitors to this one are sent to with a 301 redirect. The value is null when this domain serves the app itself.

provider_idstring nullable

Names the registrar when the domain was bought through Base44's Wix flow. The value is null otherwise, which covers both a domain you own elsewhere and one bought through the Entri flow, so this isn't a purchased-versus-external signal.

Example response

{
  "id": "68b1c0d4e7b91d003c45a1f7",
  "domain": "example.com",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "last_status_check": "2026-08-15T09:10:00",
  "last_status_payload": {
    "verificationStatus": "verified"
  },
  "redirect_target_domain": "www.example.com",
  "provider_id": "wix"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.