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

# List custom domains

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

Returns every custom domain attached to the app.

The list covers domains at any stage:

- Added, but not linked
- Linked, but not yet verified
- Live
- Redirecting to another domain
- Disabled

Adding a domain and linking it are separate steps. DNS propagation happens outside Base44, so a linked domain can sit unverified for as long as its nameservers take.

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



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/custom-domains
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:
    get:
      summary: List custom domains
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns every custom domain attached to the app.


        The list covers domains at any stage:


        - Added, but not linked

        - Linked, but not yet verified

        - Live

        - Redirecting to another domain

        - Disabled


        Adding a domain and linking it are separate steps. DNS propagation
        happens outside Base44, so a linked domain can sit unverified for as
        long as its nameservers take.


        <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>
      operationId: list_domains_api_apps__app_id__custom_domains_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
      responses:
        '200':
          description: The app's custom domains.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CustomDomainResource'
                title: CustomDomains
        '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: App not found.
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.

````