Get custom domain

Changed on

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

Returns one custom domain by ID.

This reads Base44's stored copy of the domain and never contacts the hosting provider, so last_status_check and last_status_payload are only as current as the last status check that ran. Use Get custom domain status when you need the provider's answer now.

<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>

get/api/apps/{app_id}/custom-domains/{domain_id}

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}
  • Auth: HTTP bearer

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.

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

  • b92cc2f13639Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 5e139db2e643Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API