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

# Get DNS Setup Status

> Check DNS setup status for a purchased domain.

Returns current setup status, zone ID, nameservers, and progress details.



## OpenAPI

````yaml GET /api/v1/registrar/domains/{domain}/dns-status
openapi: 3.1.0
info:
  title: Dotlet API
  description: >-
    The Dotlet API lets you search, register, and manage domains, configure DNS
    records, and embed domain purchasing flows in your own product.


    All endpoints are authenticated with an API key or bearer token, and all
    request and response bodies are JSON.
  version: 0.1.1
  contact:
    name: Dotlet Support
    url: https://dotlet.net/support
    email: support@dotlet.net
servers:
  - url: https://api.dotlet.net
    description: Production
security: []
tags:
  - name: Domains
    description: Search, price, register, renew, and manage domains.
  - name: Orders
    description: Create and track domain orders separately from immediate purchases.
  - name: DNS
    description: Manage DNS records for domains hosted with Dotlet.
  - name: Hosted Sessions
    description: Create embeddable, scoped sessions for end users in your own product.
paths:
  /api/v1/registrar/domains/{domain}/dns-status:
    get:
      tags:
        - Domains
      summary: Get Dns Setup Status
      description: >-
        Check DNS setup status for a purchased domain.


        Returns current setup status, zone ID, nameservers, and progress
        details.
      operationId: get_dns_setup_status_api_v1_registrar_domains__domain__dns_status_get
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
            title: Domain
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DNSSetupStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    DNSSetupStatusResponse:
      properties:
        domain:
          type: string
          title: Domain
        status:
          type: string
          title: Status
        provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Provider
        zone_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Zone Id
        nameservers:
          items:
            type: string
          type: array
          title: Nameservers
          default: []
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        progress:
          anyOf:
            - $ref: '#/components/schemas/DNSSetupProgressResponse'
            - type: 'null'
        dns_api_ready:
          type: boolean
          title: Dns Api Ready
          default: false
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
        dns_endpoints:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Dns Endpoints
      type: object
      required:
        - domain
        - status
      title: DNSSetupStatusResponse
      description: Response for DNS setup status check
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DNSSetupProgressResponse:
      properties:
        zone_created:
          type: boolean
          title: Zone Created
          default: false
        ns_updated_at_registrar:
          type: boolean
          title: Ns Updated At Registrar
          default: false
        ns_delegation_verified:
          type: boolean
          title: Ns Delegation Verified
          default: false
      type: object
      title: DNSSetupProgressResponse
      description: DNS setup progress details
    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:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````