> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get custom domain status
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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](/api-reference/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".
The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/custom-domains/{domain_id}/status
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/custom-domains/{domain_id}/status:
post:
summary: Get custom domain status
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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](/api-reference/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".
The response includes fields beyond the ones documented here.
Don't rely on undocumented response fields, as they can change at any
time.
operationId: get_status_api_apps__app_id__custom_domains__domain_id__status_post
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app the domain belongs to.
title: App Id
description: ID of the app the domain belongs to.
example: 6820f3a4e7b91d003c45a1f2
- name: domain_id
in: path
required: true
schema:
type: string
description: >-
ID of the custom domain. Get this from [List custom
domains](/api-reference/list-custom-domains).
title: Domain Id
description: >-
ID of the custom domain. Get this from [List custom
domains](/api-reference/list-custom-domains).
example: 68b1c0d4e7b91d003c45a1f7
responses:
'200':
description: >-
The domain, with the provider's answer written into its status
fields.
content:
application/json:
schema:
$ref: '#/components/schemas/CustomDomainResource'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have access to this app, or you used a workspace API key.
These endpoints take a personal API key.
'404':
description: The app has no custom domain with this ID, or the app doesn't exist.
components:
schemas:
CustomDomainResource:
properties:
id:
type: string
title: Id
description: >-
ID of the domain. Pass it as `domain_id` to the other domain
endpoints.
example: 68b1c0d4e7b91d003c45a1f7
domain:
type: string
title: Domain
description: >-
The domain name, normalized to lower case with any scheme, trailing
slash and leading `www.` removed.
example: example.com
app_id:
type: string
title: App Id
description: ID of the app the domain serves.
example: 6820f3a4e7b91d003c45a1f2
disabled:
type: boolean
title: Disabled
description: >-
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.
example: false
last_status_check:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Last Status Check
description: >-
When [Get custom domain
status](/api-reference/get-custom-domain-status) last ran for this
domain, as a UTC timestamp in ISO 8601 format, or `null` if it never
has.
example: '2026-08-15T09:10:00'
last_status_payload:
anyOf:
- $ref: '#/components/schemas/CustomDomainStatusPayload'
- type: 'null'
description: >-
The provider's last report on the domain, or `null` until a status
check has run.
redirect_target_domain:
anyOf:
- type: string
- type: 'null'
title: Redirect Target Domain
description: >-
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.
example: www.example.com
provider_id:
anyOf:
- type: string
- type: 'null'
title: Provider Id
description: >-
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: wix
type: object
required:
- id
- domain
- app_id
- disabled
title: CustomDomainResource
description: A custom domain attached to an app.
CustomDomainStatusPayload:
properties:
verificationStatus:
anyOf:
- type: string
- type: 'null'
title: Verificationstatus
description: >-
Whether the provider has verified the domain's DNS. Only `verified`
means the domain serves the app, and anything else means it doesn't
yet. Absent until [Get custom domain
status](/api-reference/get-custom-domain-status) has run once.
example: verified
type: object
title: CustomDomainStatusPayload
description: What the hosting provider last reported about the domain.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````