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

# Assembly orders

> Get a paginated list of assembly orders, newest first. Disassembly orders are not included.

Filters use the standard [filter syntax](/filters), for example `status=issued`,
`created_at[gte]=2026-08-01`, or `end_time[gte]=...&end_time[lte]=...`.




## OpenAPI

````yaml /api-reference/build.yaml get /assembly-orders
openapi: 3.0.0
info:
  title: Luminous API
  version: 1.0.0
  description: API documentation for Luminous
servers:
  - url: https://{companyName}.api.joinluminous.com/external/api/v1
    variables:
      companyName:
        default: companyName
        description: Your company-specific subdomain
security: []
tags:
  - name: Products
    description: Get and manage products
  - name: Pricing
    description: Manage price schedules, levels, and customizations
  - name: BOMs
    description: Manage Bills of Materials (BOMs)
  - name: Labels
    description: Label rendering via Labelary ZPL service
  - name: Companies
    description: Manage business accounts and their associated data
  - name: Contacts
    description: Manage contact information for individuals
  - name: Suppliers
    description: Manage suppliers (factories) — vendors used on purchase orders
  - name: Supplier SKUs
    description: Manage per-supplier SKU and unit-cost overrides for products
  - name: Locations
    description: Manage warehouses and locations
  - name: Inventory
    description: Get and adjust product stock levels
  - name: Lots
    description: Create, update, and delete product lots (batches)
  - name: Transfer Orders
    description: Manage transfer orders
  - name: Fulfillment Orders
    description: Manage fulfillment orders and picklists
  - name: Freight
    description: >-
      Freightview LTL freight — quotes, booking and documents for fulfillment
      orders
  - name: Fulfillment Priority Lists
    description: Configure fulfillment routing priority lists
  - name: Purchase Orders
    description: Get and modify purchase orders
  - name: Supplier Portal
    description: >-
      Read a supplier's response to a purchase order and control the one-click
      portal link
  - name: Receiving Reports
    description: Manage receiving reports
  - name: Payment Obligations
    description: Manage payment obligations for purchase orders
  - name: Sales Orders
    description: Manage sales orders and sales order shipments
  - name: Purgatory
    description: >-
      Inspect and resolve non-posted sales orders in the purgatory staging
      workflow
  - name: PickFlow Warehouse
    description: >-
      Warehouse-floor lookups for PickFlow — barcode resolution, bin and product
      stock, bin search, and receivables
  - name: PickFlow Shipping
    description: >-
      Provider-agnostic shipping rates, services, packages, and label purchase
      for PickFlow
  - name: Cycle Counts
    description: >-
      Create, drive, and post PickFlow cycle counts — batches, per-warehouse
      sessions, and CSV import/export
  - name: Print Stations
    description: List paired print stations and enqueue print jobs to them
  - name: Invoices
    description: Get and manage invoices
  - name: Work Orders
    description: >-
      Manage work orders — production lifecycle, steps, materials, links,
      shipments, and comments
  - name: Production Batches
    description: Group and manage work orders as production batches
  - name: Bills
    description: >-
      Accounts payable bill management, payments, attachments, allocations, and
      variance
  - name: Prepayments
    description: Manage vendor prepayments and applications
  - name: Vendor Credits
    description: Manage vendor credits and applications
  - name: Vendor Returns
    description: Manage vendor returns and credit generation
  - name: Customer Returns
    description: Manage customer returns (sales returns), receiving, and restock behavior
  - name: Stock Snapshot
    description: Point-in-time stock snapshots with export support
  - name: Consumption
    description: Consumption reports and exports
  - name: Inventory Aging
    description: Cost-layer-based inventory aging reports
  - name: Bills Reports
    description: Accounts payable bills aging reports
  - name: Forecast
    description: Materialized forecast data
  - name: Reports
    description: Close the books, inventory discrepancy, transaction COGS, and EDI reports
  - name: Tags
    description: Add/remove tags across various resources
  - name: Custom Fields
    description: Get and set custom fields across various resources
  - name: Currency
    description: Currency configuration, exchange rates, and conversion
  - name: Drive
    description: >
      Browse, upload, tag and manage files in your Luminous Drive. An API token
      sees the shared

      drive only, never My Files or restricted folders and files. Every write
      and download made

      through the API is recorded in the file's activity log (`GET
      /file-cabinet/files/{id}/activity`)

      with `actor_kind: api_token`.
  - name: Integration Mappings
    description: Manage integration mappings for external systems
  - name: Integration Field Mappings
    description: Manage field-level mappings between Luminous and external systems
  - name: Automations
    description: Create, test, and inspect automation rules and their runs
paths:
  /assembly-orders:
    get:
      tags:
        - Assembly Orders
      summary: Assembly orders
      description: >
        Get a paginated list of assembly orders, newest first. Disassembly
        orders are not included.


        Filters use the standard [filter syntax](/filters), for example
        `status=issued`,

        `created_at[gte]=2026-08-01`, or `end_time[gte]=...&end_time[lte]=...`.
      operationId: getAssemblyOrders
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: Page number for pagination
        - in: query
          name: per_page
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 15
          description: Number of items per page (max 100)
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
          description: Page size used when `per_page` is omitted.
        - in: query
          name: status
          schema:
            type: string
            enum:
              - draft
              - issued
              - in_progress
              - paused
              - completed
              - rolled_back
          description: Filter by status. Supports `status[in]=issued,in_progress`.
        - in: query
          name: bom_id
          schema:
            type: integer
          description: Filter by BOM ID
        - in: query
          name: rfq_id
          schema:
            type: integer
          description: Filter by the ID of the product being assembled
        - in: query
          name: warehouse_id
          schema:
            type: integer
          description: Filter by warehouse ID
        - in: query
          name: created_at[gte]
          schema:
            type: string
            format: date
          description: Created on or after this date
        - in: query
          name: created_at[lte]
          schema:
            type: string
            format: date
          description: Created on or before this date
        - in: query
          name: end_time[gte]
          schema:
            type: string
            format: date-time
          description: End time on or after this value
        - in: query
          name: end_time[lte]
          schema:
            type: string
            format: date-time
          description: End time on or before this value
      responses:
        '200':
          description: Paginated list of assembly orders
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      description: >-
                        An assembly order. Disassembly orders are not returned
                        by these endpoints.
                      properties:
                        id:
                          type: integer
                        status:
                          type: string
                          enum:
                            - draft
                            - issued
                            - in_progress
                            - paused
                            - completed
                            - rolled_back
                        planned_quantity:
                          type: number
                          description: Quantity planned to assemble.
                        actual_quantity:
                          type: number
                          description: Quantity actually assembled.
                        start_time:
                          type: string
                          format: date-time
                          nullable: true
                          description: >-
                            Scheduled or actual start. Assembly orders have no
                            separate due date; `start_time` and `end_time` are
                            the schedule fields.
                        end_time:
                          type: string
                          format: date-time
                          nullable: true
                        bom_id:
                          type: integer
                          nullable: true
                          description: BOM used for the assembly.
                        rfq_id:
                          type: integer
                          description: ID of the product being assembled.
                        warehouse_id:
                          type: integer
                          nullable: true
                        product_name:
                          type: string
                          nullable: true
                          description: Name of the product being assembled.
                        sku:
                          type: string
                          nullable: true
                          description: SKU of the product being assembled.
                        created_at:
                          type: string
                          format: date-time
                        updated_at:
                          type: string
                          format: date-time
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: The current page number
                        example: 1
                      from:
                        type: integer
                        description: The starting index of the paginated results
                        example: 1
                      last_page:
                        type: integer
                        description: The last page number
                        example: 5
                      per_page:
                        type: integer
                        description: Number of items per page
                        example: 10
                      to:
                        type: integer
                        description: The ending index of the paginated results
                        example: 10
                      total:
                        type: integer
                        description: Total number of items across all pages
                        example: 50
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
        '422':
          description: A filter value is not recognized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authenticate using a bearer token. To create a token, navigate to
        /settings/api-tokens and click Create API Token.

````

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