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

# Get Domain

> Read one app-owned custom domain and its DNS records.



## OpenAPI

````yaml https://api.getfloo.com/openapi.json get /v1/apps/{app_id}/domains/{hostname}
openapi: 3.1.0
info:
  title: floo API
  version: 0.1.0
servers:
  - url: https://api.getfloo.com
security: []
paths:
  /v1/apps/{app_id}/domains/{hostname}:
    get:
      tags:
        - domains
      summary: Get Domain
      description: Read one app-owned custom domain and its DNS records.
      operationId: domains_get_domain
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: App Id
        - name: hostname
          in: path
          required: true
          schema:
            type: string
            title: Hostname
        - $ref: '#/components/parameters/X-Floo-Org-Id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  parameters:
    X-Floo-Org-Id:
      name: X-Floo-Org-Id
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: Organization to act in; defaults to the one joined most recently.
  schemas:
    DomainResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        app_id:
          type: string
          format: uuid
          title: App Id
        hostname:
          type: string
          title: Hostname
        status:
          type: string
          title: Status
        status_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Status Reason
        blocker:
          anyOf:
            - $ref: '#/components/schemas/DomainBlocker'
            - type: 'null'
        ssl_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Ssl Status
        verified:
          type: boolean
          title: Verified
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        dns_records:
          items:
            $ref: '#/components/schemas/DnsRecord'
          type: array
          title: Dns Records
        service_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Service Id
        service_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Service Name
        env_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Env Id
        env:
          anyOf:
            - type: string
            - type: 'null'
          title: Env
      type: object
      required:
        - id
        - app_id
        - hostname
        - status
        - created_at
        - updated_at
        - dns_records
      title: DomainResponse
      description: Response for a single domain.
    ErrorResponse:
      properties:
        detail:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - detail
      title: ErrorResponse
      description: Body of every error response except request validation (422).
    DomainBlocker:
      type: string
      enum:
        - AWAITING_DNS
        - CERT_ISSUING
        - CERT_FAILED
        - HOSTNAME_HELD_BY_ANOTHER_APP
        - NOT_ROUTABLE
        - PROVIDER_ERROR
      title: DomainBlocker
      description: Actionable reason a declared domain is not active.
    DnsRecord:
      properties:
        type:
          type: string
          enum:
            - CNAME
            - A
          title: Type
        name:
          type: string
          title: Name
        value:
          type: string
          title: Value
        purpose:
          type: string
          enum:
            - traffic
            - traffic_apex
            - certificate
          title: Purpose
          description: >-
            `traffic_apex` records replace the `traffic` CNAME only at a zone
            apex, where a CNAME is not allowed.
      type: object
      required:
        - type
        - name
        - value
        - purpose
      title: DnsRecord
      description: DNS record a domain owner should publish.
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      additionalProperties: true
      type: object
      required:
        - code
        - message
      title: ErrorDetail
      description: Standard error envelope with operation-specific JSON context.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A `floo_` API key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.