> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the application's planned address

> The address the application's first deploy would publish on, knowable from birth when the organisation's preview domain is published by one of its clusters. A read, not a reservation: the deploy's own derivation stays the authority on what is published. state is planned (host named), none (nothing to name yet - the reason says why) or unknown (the organisation's DNS settings could not be read, which is not an organisation without a preview domain).



## OpenAPI

````yaml https://platform.ankra.app/openapi.json get /org/applications/{application_id}/planned-address
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://platform.ankra.app
security: []
paths:
  /org/applications/{application_id}/planned-address:
    get:
      tags:
        - applications
      summary: Get the application's planned address
      description: >-
        The address the application's first deploy would publish on, knowable
        from birth when the organisation's preview domain is published by one of
        its clusters. A read, not a reservation: the deploy's own derivation
        stays the authority on what is published. state is planned (host named),
        none (nothing to name yet - the reason says why) or unknown (the
        organisation's DNS settings could not be read, which is not an
        organisation without a preview domain).
      operationId: get_application_planned_address
      parameters:
        - in: path
          name: application_id
          required: true
          schema:
            title: Application Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationPlannedAddressResponse'
          description: Successful Response
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoDetailError'
          description: Not found ("Application not found")
components:
  schemas:
    ApplicationPlannedAddressResponse:
      properties:
        application_id:
          title: Application Id
          type: string
        state:
          enum:
            - planned
            - none
            - unknown
          title: State
          type: string
        host:
          title: Host
          type: string
        domain:
          title: Domain
          type: string
        domain_source:
          title: Domain Source
          type: string
        reason:
          title: Reason
          type: string
      required:
        - application_id
        - state
        - host
        - domain
        - domain_source
        - reason
      title: ApplicationPlannedAddressResponse
      type: object
    DemoDetailError:
      description: >-
        The FastAPI-style detail envelope the demo routes use for
        400/403/404/409/502 responses.
      properties:
        detail:
          type: string
      required:
        - detail
      type: object

````