> ## 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
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns one custom domain by ID.
Same shape as one entry from [List custom domains](/api-reference/list-custom-domains). The status fields are whatever the last status check wrote, which can be old: this endpoint reads Base44's copy and does not ask the hosting provider. Call [Get custom domain status](/api-reference/get-custom-domain-status) when you need a fresh answer.
This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.
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 get /api/apps/{app_id}/custom-domains/{domain_id}
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}:
get:
summary: Get custom domain
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns one custom domain by ID.
Same shape as one entry from [List custom
domains](/api-reference/list-custom-domains). The status fields are
whatever the last status check wrote, which can be old: this endpoint
reads Base44's copy and does not ask the hosting provider. Call [Get
custom domain status](/api-reference/get-custom-domain-status) when you
need a fresh answer.
This endpoint accepts a personal API key. Workspace API keys are
not authorized for it and are rejected with a 403.
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_domain_api_apps__app_id__custom_domains__domain_id__get
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, as returned in `id` by [List custom
domains](/api-reference/list-custom-domains).
title: Domain Id
description: >-
ID of the custom domain, as returned in `id` by [List custom
domains](/api-reference/list-custom-domains).
example: 68b1c0d4e7b91d003c45a1f7
responses:
'200':
description: The domain.
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.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
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: lower-cased, 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
keeps its DNS and its row, 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, or `null` if it never has.
example: '2026-08-15T09:10:00Z'
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. Only `verificationStatus` is part of this API; the
provider sends other keys and they can change.
redirect_target_domain:
anyOf:
- type: string
- type: 'null'
title: Redirect Target Domain
description: >-
The domain this one 301-redirects to, or `null` when it 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. `null` otherwise, which covers both a domain you own elsewhere
and one bought through the Entri flow, so this is not 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.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CustomDomainStatusPayload:
properties:
verificationStatus:
anyOf:
- type: string
- type: 'null'
title: Verificationstatus
description: >-
Whether the provider has verified the domain's DNS. `verified` is
the only value that means the domain serves the app; anything else
means it does not 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.
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````