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

# List Domains

> List all domains registered through the registrar account.



## OpenAPI

````yaml GET /api/v1/registrar/domains
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:
    get:
      tags:
        - Domains
      summary: List Domains
      description: List all domains registered through the registrar account.
      operationId: list_domains_api_v1_registrar_domains_get
      parameters:
        - name: registrar
          in: query
          required: false
          schema:
            type: string
            default: namecheap
            title: Registrar
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    DomainListResponse:
      properties:
        domains:
          items:
            $ref: '#/components/schemas/DomainInfoResponse'
          type: array
          title: Domains
        total:
          type: integer
          title: Total
      type: object
      required:
        - domains
        - total
      title: DomainListResponse
      description: List of domains
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DomainInfoResponse:
      properties:
        domain:
          type: string
          title: Domain
        status:
          $ref: '#/components/schemas/RegistrationStatus'
        registration_date:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Registration Date
        expiry_date:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expiry Date
        nameservers:
          items:
            type: string
          type: array
          title: Nameservers
          default: []
        auto_renew:
          type: boolean
          title: Auto Renew
          default: false
        locked:
          type: boolean
          title: Locked
          default: false
        privacy_enabled:
          type: boolean
          title: Privacy Enabled
          default: false
        registrar_domain_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Registrar Domain Id
      type: object
      required:
        - domain
        - status
      title: DomainInfoResponse
      description: Detailed domain information
    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
    RegistrationStatus:
      type: string
      enum:
        - active
        - expired
        - pending
        - locked
        - suspended
      title: RegistrationStatus
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````