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

> List all domain orders for the authenticated organization.

Supports filtering by status and pagination. Returns order summaries
including domain name, price, payment status, and order status.

Query Parameters:
- page: Page number (1-indexed, default: 1)
- page_size: Number of records per page (default: 10)
- order_status: Filter by order status (pending, ready_to_process, processing, completed, failed, cancelled)



## OpenAPI

````yaml GET /api/v1/registrar/orders
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/orders:
    get:
      tags:
        - Orders
      summary: List Orders
      description: >-
        List all domain orders for the authenticated organization.


        Supports filtering by status and pagination. Returns order summaries

        including domain name, price, payment status, and order status.


        Query Parameters:

        - page: Page number (1-indexed, default: 1)

        - page_size: Number of records per page (default: 10)

        - order_status: Filter by order status (pending, ready_to_process,
        processing, completed, failed, cancelled)
      operationId: list_orders_api_v1_registrar_orders_get
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            title: Page
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 10
            title: Page Size
        - name: order_status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Order Status
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedDomainOrderResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    PaginatedDomainOrderResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/DomainOrderSummary'
          type: array
          title: Items
        total:
          type: integer
          title: Total
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
        total_pages:
          type: integer
          title: Total Pages
      type: object
      required:
        - items
        - total
        - page
        - page_size
        - total_pages
      title: PaginatedDomainOrderResponse
      description: Paginated list of domain orders
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DomainOrderSummary:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        domain_name:
          type: string
          title: Domain Name
        price:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Price
        amount_paid:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount Paid
        amount_due:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount Due
        fully_paid:
          type: boolean
          title: Fully Paid
        status:
          $ref: '#/components/schemas/DomainOrderStatus'
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - id
        - domain_name
        - price
        - amount_paid
        - amount_due
        - fully_paid
        - status
        - created_at
      title: DomainOrderSummary
      description: Summary of a domain order for list views
    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
    DomainOrderStatus:
      type: string
      enum:
        - pending
        - ready_to_process
        - price_changed
        - processing
        - completed
        - failed
        - cancelled
        - refunded
      title: DomainOrderStatus
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````