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

# List all orders

> Retrieve a paginated list of all processed orders with their current status.



## OpenAPI

````yaml GET /order_status/list
openapi: 3.1.0
info:
  title: DocOpsAI API
  version: 0.1.0
  description: >
    AI-based order processing application that extracts information from email
    attachments and forwards to backend systems. Provides endpoints for order
    management, customer and product CRUD, email watching, and template
    parameter configuration.
  contact:
    name: DevOps Company
servers:
  - url: https://start.aiotic.ai
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: healthcheck
    description: Service health monitoring
  - name: order
    description: Order document upload and processing
  - name: order_status
    description: Order processing status tracking
  - name: customer
    description: Customer record management with vector search
  - name: product
    description: Product record management
  - name: template_parameters
    description: Prompt template parameter management
  - name: email-watcher
    description: Email inbox monitoring and processing
paths:
  /order_status/list:
    get:
      tags:
        - order_status
      summary: List all orders
      description: >-
        Retrieve a paginated list of all processed orders with their current
        status.
      operationId: listOrders
      parameters:
        - $ref: '#/components/parameters/PageQuery'
        - $ref: '#/components/parameters/SizeQuery'
      responses:
        '200':
          description: Paginated list of orders
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderListResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    PageQuery:
      name: page
      in: query
      required: false
      description: Page number (starts at 1)
      schema:
        type: integer
        default: 1
        minimum: 1
    SizeQuery:
      name: size
      in: query
      required: false
      description: Items per page
      schema:
        type: integer
        default: 100
        minimum: 1
        maximum: 1000
  schemas:
    OrderListResponse:
      type: object
      required:
        - items
        - total
        - limit
        - offset
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/OrderStatus'
          description: List of order status objects
        total:
          type: integer
          description: Total number of orders in the system
        limit:
          type: integer
          description: Maximum number of orders returned in this response
        offset:
          type: integer
          description: Number of orders skipped (for pagination)
    ErrorResponse:
      type: object
      required:
        - detail
      properties:
        detail:
          type: string
          description: Error message describing what went wrong
    OrderStatus:
      type: object
      required:
        - request_id
        - timestamp
        - status
      properties:
        request_id:
          type: string
          format: uuid
          description: Unique identifier for the request
        attachments:
          type: object
          additionalProperties: true
          description: Dictionary of file names to file metadata
          default: {}
        metadata:
          type: object
          additionalProperties: true
          description: Additional metadata associated with the document
          default: {}
        timestamp:
          type: string
          format: date-time
          description: When this status was recorded
        status:
          type: string
          enum:
            - QUEUED
            - PROCESSING
            - ATTENTION
            - PROCESSED
            - FAILED
            - MODIFIED
            - REPROCESSED
            - SENT
          description: Current processing status of the document
        result:
          type: object
          additionalProperties: true
          nullable: true
          description: JSON data containing the parsed document result
        state:
          type: object
          additionalProperties: true
          nullable: true
          description: JSON data containing the processing state
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >
        API key for authentication. Required on all endpoints except
        /healthcheck. Customer and product endpoints also accept a
        customer-specific API key.

````