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

# Order - Get Archived

> Retrieve archived orders with optional filtering.



## OpenAPI

````yaml get /order/get_archived
openapi: 3.0.3
info:
  title: SKULabs API
  description: >-
    Most API keys have "platformGeneric" and "platformApi" scopes included.
    Contact us to convert more routes from "platformUser" (only available to
    users) to "platformGeneric" (available to users and api keys) upon request.
  version: 4.5.0
servers:
  - url: https://api.skulabs.com
  - url: https://app.skulabs.com/s
security: []
tags:
  - name: batch
  - name: customer
    description: Manage customers, tags, and notes
  - name: cycle_count
  - name: distributor
  - name: inventory
    description: Query and modify inventory levels across locations
  - name: inventory_table
  - name: item
    description: Manage items, barcodes, serial numbers, and tags
  - name: kit
    description: Manage kits and their component items
  - name: listing
  - name: location
  - name: oauth
  - name: order
    description: Manage orders, shipments, tags, and statuses
  - name: purchase_order
    description: Manage purchase orders and receiving
  - name: run
  - name: shipments
  - name: shipping
  - name: store
  - name: tag
    description: Create, update, and remove tags
  - name: transfer_order
  - name: warehouse
    description: Manage warehouses and view statistics
  - name: webhook
    description: Manage webhook handlers
paths:
  /order/get_archived:
    get:
      tags:
        - order
      summary: Order - Get Archived
      description: Retrieve archived orders with optional filtering.
      operationId: get_order_get_archived
      parameters:
        - name: start
          in: query
          required: true
          schema:
            type: string
            format: date
            description: Start date
            example: '2024-01-01'
        - name: end
          in: query
          required: true
          schema:
            type: string
            format: date
            description: End date
            example: '2024-12-31'
        - name: tags
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: >-
              Filter by tag IDs (ObjectId strings referencing the tag
              collection)
            example:
              - 507f1f77bcf86cd799439011
        - name: store_ids
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: Filter by store IDs
      responses:
        '200':
          description: Archived orders
          content:
            application/json:
              schema:
                type: object
                properties:
                  orders:
                    type: array
                    items:
                      $ref: '#/components/schemas/OrderShippedListItem'
                    description: Archived order list
                  db_time:
                    type: number
                    description: Query execution time (ms)
                  process_time:
                    type: number
                    description: Processing time (ms)
                  message:
                    type: string
                    description: Limit warning message if result was truncated
                required:
                  - orders
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Detailed error message
                      code:
                        type: string
                        description: Machine-readable error code
                      overview:
                        type: string
                        description: Short human-friendly description
                      statusCode:
                        type: number
                        description: HTTP status code
                      origin:
                        type: string
                        description: Error source
                      skulabsTraceId:
                        type: string
                        description: Trace ID for support
                      type:
                        type: string
                        enum:
                          - error
                          - notice
                          - success
                        description: Error severity for UI handling
                      user_error:
                        type: boolean
                        description: Whether the error was caused by user input
                      display:
                        type: string
                        enum:
                          - notification
                          - panel
                        description: Suggested UI display mode for the error
                    required:
                      - message
                      - statusCode
                required:
                  - error
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Detailed error message
                      code:
                        type: string
                        description: Machine-readable error code
                      overview:
                        type: string
                        description: Short human-friendly description
                      statusCode:
                        type: number
                        description: HTTP status code
                      origin:
                        type: string
                        description: Error source
                      skulabsTraceId:
                        type: string
                        description: Trace ID for support
                      type:
                        type: string
                        enum:
                          - error
                          - notice
                          - success
                        description: Error severity for UI handling
                      user_error:
                        type: boolean
                        description: Whether the error was caused by user input
                      display:
                        type: string
                        enum:
                          - notification
                          - panel
                        description: Suggested UI display mode for the error
                    required:
                      - message
                      - statusCode
                required:
                  - error
        '403':
          description: Forbidden. Insufficient permissions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Detailed error message
                      code:
                        type: string
                        description: Machine-readable error code
                      overview:
                        type: string
                        description: Short human-friendly description
                      statusCode:
                        type: number
                        description: HTTP status code
                      origin:
                        type: string
                        description: Error source
                      skulabsTraceId:
                        type: string
                        description: Trace ID for support
                      type:
                        type: string
                        enum:
                          - error
                          - notice
                          - success
                        description: Error severity for UI handling
                      user_error:
                        type: boolean
                        description: Whether the error was caused by user input
                      display:
                        type: string
                        enum:
                          - notification
                          - panel
                        description: Suggested UI display mode for the error
                    required:
                      - message
                      - statusCode
                required:
                  - error
        '429':
          description: Too many requests. Rate limit exceeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Detailed error message
                      code:
                        type: string
                        description: Machine-readable error code
                      overview:
                        type: string
                        description: Short human-friendly description
                      statusCode:
                        type: number
                        description: HTTP status code
                      origin:
                        type: string
                        description: Error source
                      skulabsTraceId:
                        type: string
                        description: Trace ID for support
                      type:
                        type: string
                        enum:
                          - error
                          - notice
                          - success
                        description: Error severity for UI handling
                      user_error:
                        type: boolean
                        description: Whether the error was caused by user input
                      display:
                        type: string
                        enum:
                          - notification
                          - panel
                        description: Suggested UI display mode for the error
                    required:
                      - message
                      - statusCode
                required:
                  - error
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Detailed error message
                      code:
                        type: string
                        description: Machine-readable error code
                      overview:
                        type: string
                        description: Short human-friendly description
                      statusCode:
                        type: number
                        description: HTTP status code
                      origin:
                        type: string
                        description: Error source
                      skulabsTraceId:
                        type: string
                        description: Trace ID for support
                      type:
                        type: string
                        enum:
                          - error
                          - notice
                          - success
                        description: Error severity for UI handling
                      user_error:
                        type: boolean
                        description: Whether the error was caused by user input
                      display:
                        type: string
                        enum:
                          - notification
                          - panel
                        description: Suggested UI display mode for the error
                    required:
                      - message
                      - statusCode
                required:
                  - error
      security:
        - SKULabsToken: []
      servers:
        - url: https://api.skulabs.com
components:
  schemas:
    OrderShippedListItem:
      type: object
      properties:
        store_id:
          type: string
          description: Store identifier
          example: 507f1f77bcf86cd799439011
        order_number:
          type: string
          description: Order number
        status:
          type: string
          enum:
            - unstarted
            - in_progress
            - shipped
            - cancelled
            - cleared
            - delayed
            - stopped
            - partially shipped
            - archived
            - awaiting fulfillment
            - pending
            - partially cleared
          description: Order status
        type:
          type: string
          enum:
            - manual
            - combined
            - split
            - combined_child
            - split_parent
          description: Order type
        stash:
          $ref: '#/components/schemas/OrderStash'
        log:
          type: array
          items:
            $ref: '#/components/schemas/OrderLogEntry'
          description: Order log entries
        batch_number:
          type: number
          nullable: true
          description: Batch number
        location:
          type: string
          description: Assigned location name
        warehouse_id:
          type: string
          description: Warehouse ID
        shipments:
          type: array
          items:
            $ref: '#/components/schemas/Shipment'
          description: Shipment records
        notes:
          type: array
          items:
            $ref: '#/components/schemas/OrderNote'
          description: Order notes
        shipped_date:
          type: string
          description: Shipped date
          example: '2025-01-15T12:00:00.000Z'
        last_shipment_date:
          type: string
          description: Date of last shipment
          example: '2025-01-15T12:00:00.000Z'
        tags:
          type: array
          items:
            type: string
          description: Array of tag IDs (ObjectId strings referencing the tag collection)
          example:
            - 507f1f77bcf86cd799439011
            - 507f1f77bcf86cd799439012
        channel_status:
          type: string
          nullable: true
          description: Channel-reported status
        marked_as_shipped:
          type: boolean
          description: Whether marked as shipped on channel
        processing:
          type: boolean
          description: Whether the order is processing
        date:
          type: string
          description: Order date (copied from stash.date)
          example: '2025-01-15'
        archived:
          type: boolean
          description: Whether the order is archived
    OrderStash:
      type: object
      properties:
        store_id:
          type: string
          description: Store ID
          example: 507f1f77bcf86cd799439011
        id:
          type: string
          description: Order ID from the channel
        date:
          type: string
          description: Order date
          example: '2025-01-15'
        items:
          type: array
          items:
            $ref: '#/components/schemas/StashItem'
          description: Line items from the channel
        shipping_information:
          $ref: '#/components/schemas/ShippingInformation'
        total:
          type: number
          description: Order total
        tax:
          type: number
          description: Tax amount
        shipping:
          type: number
          description: Shipping cost
        discount:
          type: number
          description: Discount amount
        notes:
          type: string
          description: Channel notes
        alternate_order_id:
          type: string
          description: Alternate order identifier
        order_id:
          type: string
          description: Raw order ID from channel
        currency:
          type: string
          description: Currency code
      description: Channel data stash
    OrderLogEntry:
      type: object
      properties:
        user_id:
          type: string
          nullable: true
          description: User ID who performed the action
          example: 507f1f77bcf86cd799439011
        action:
          type: string
          description: Action performed (e.g. shipped, cancelled, overrode)
        time:
          type: string
          description: ISO timestamp of the action
          example: '2025-01-15T12:00:00.000Z'
        details:
          nullable: true
          description: Additional details about the action
    Shipment:
      type: object
      properties:
        _id:
          type: string
          description: Shipment ID
          example: 507f1f77bcf86cd799439011
        user_id:
          type: string
          description: User who created the shipment
          example: 507f1f77bcf86cd799439011
        time:
          type: string
          description: Shipment creation time
          example: '2025-01-15T12:00:00.000Z'
        voided:
          type: boolean
          description: Whether the shipment is voided
        return_label:
          type: boolean
          description: Whether this is a return label
        deducted:
          type: boolean
          description: Whether inventory was deducted
        response:
          type: object
          properties:
            provider:
              type: string
              description: Carrier provider name
            service:
              type: string
              description: Service name
            label_url:
              type: string
              description: Label URL
            tracking_number:
              type: string
              description: Tracking number
            tracking_url:
              type: string
              description: Tracking URL
            amount:
              type: number
              description: Shipping cost amount
            currency:
              type: string
              description: Currency code
            shipment_id:
              type: string
              description: External shipment ID
            signature:
              type: boolean
              description: Signature confirmation
          description: Shipment response details
        request:
          type: object
          properties:
            order_items:
              type: array
              items:
                $ref: '#/components/schemas/ShipmentOrderItem'
              description: Items included in shipment
            parcel:
              type: object
              properties:
                length:
                  type: number
                  description: Package length
                width:
                  type: number
                  description: Package width
                height:
                  type: number
                  description: Package height
                weight:
                  type: number
                  description: Package weight
                weight_unit:
                  type: string
                  description: Weight unit
                dimensions_unit:
                  type: string
                  description: Dimensions unit
              description: Parcel dimensions
            address:
              type: object
              properties: {}
              description: Ship-to address used in request
            carrier_account_ids:
              type: array
              items:
                type: string
              description: Carrier account IDs
            provider:
              type: string
              description: Carrier provider
            service:
              nullable: true
              description: Service code or name
          description: Shipment request parameters
    OrderNote:
      type: object
      properties:
        _id:
          type: string
          description: Note ID
          example: 507f1f77bcf86cd799439011
        user_id:
          type: string
          description: User who created the note
          example: 507f1f77bcf86cd799439011
        time:
          type: string
          description: Note creation time
          example: '2025-01-15T12:00:00.000Z'
        note:
          type: string
          description: Note text
        type:
          type: string
          enum:
            - internal
            - customer_facing
          description: Note type
    StashItem:
      type: object
      properties:
        id:
          type: string
          description: Listing item ID
        variant_id:
          type: string
          description: Variant ID
        lineName:
          type: string
          description: Line item name
        quantity:
          type: number
          description: Quantity ordered
        price:
          type: number
          description: Unit price
        sku:
          type: string
          description: SKU of the listing
        line_id:
          type: string
          description: Unique line item ID
        metadata:
          nullable: true
          description: Additional line item metadata
        dropshipped:
          type: boolean
          description: Whether this item is dropshipped
    ShippingInformation:
      type: object
      properties:
        name:
          type: string
          description: Recipient name
        email:
          type: string
          description: Email address
        address:
          type: string
          description: Street address line 1
        street2:
          type: string
          description: Street address line 2
        city:
          type: string
          description: City
        state:
          type: string
          description: State or province
        zip:
          type: string
          description: Postal or ZIP code
        country:
          type: string
          description: Country code
        phone:
          type: string
          description: Phone number
        company:
          type: string
          description: Company name
        method:
          type: string
          description: Shipping method
        is_residential:
          type: boolean
          description: Whether the address is residential
        is_valid:
          type: boolean
          description: Whether the address has been validated
        hash:
          type: string
          description: Address validation hash
        address_type:
          type: string
          nullable: true
          description: Address type classification
        address_validation_data:
          type: object
          properties: {}
          description: Address validation result data
      description: Shipping address and info
    ShipmentOrderItem:
      type: object
      properties:
        item_id:
          type: string
          description: Item ID
        variant_id:
          type: string
          description: Variant ID
        quantity:
          type: number
          description: Quantity shipped
        sku:
          type: string
          description: Item SKU
  securitySchemes:
    SKULabsToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````