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

# Inventory Table - Export Velocity

> Export inventory velocity data (sales speed analysis) as a downloadable report.



## OpenAPI

````yaml post /s/job/inventory_table/export_velocity
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:
  /s/job/inventory_table/export_velocity:
    post:
      tags:
        - inventory_table
      summary: Inventory Table - Export Velocity
      description: >-
        Export inventory velocity data (sales speed analysis) as a downloadable
        report.
      operationId: post_inventory_table_export_velocity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/BuildRowsData'
              required:
                - data
      responses:
        '200':
          description: S3 signed URL for the exported velocity CSV file
          content:
            application/json:
              schema:
                type: object
                properties:
                  path:
                    type: string
                    nullable: true
                    description: >-
                      S3 signed URL for the exported CSV file, or null if no
                      data
                  count:
                    type: number
                    description: Number of rows exported
                required:
                  - path
                  - count
        '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://app.skulabs.com
components:
  schemas:
    BuildRowsData:
      type: object
      properties:
        type:
          type: string
          enum:
            - inventory
            - velocity
            - reorder
          description: Table type
        columns:
          type: array
          items:
            $ref: '#/components/schemas/InventoryTableColumn'
          description: Column definitions for the table
        order:
          type: array
          items:
            $ref: '#/components/schemas/InventoryTableOrderSpec'
          description: Sort order specification
        filters:
          $ref: '#/components/schemas/InventoryTableFilters'
        search:
          type: object
          properties:
            value:
              type: string
              description: Search string to filter rows
            regex:
              type: boolean
              description: Whether the search value is a regex
          description: Search parameters
        start:
          type: number
          description: Pagination offset (row index to start from)
          example: 0
        length:
          type: number
          description: Number of rows to return (-1 for all)
          example: 50
        draw:
          type: number
          description: DataTables draw counter for request/response sequencing
        num_days:
          type: number
          description: Number of days for velocity lookback (default 15)
        range:
          $ref: '#/components/schemas/InventoryTableRange'
        statuses:
          anyOf:
            - type: string
            - type: array
              items:
                type: string
          description: Order statuses to include in velocity calculation
        source:
          type: string
          description: Source context (e.g. purchase_order_add_items)
      required:
        - columns
        - order
        - start
        - length
      description: >-
        Table configuration for the velocity export (same as build_rows with
        type=velocity)
    InventoryTableColumn:
      type: object
      properties:
        data:
          type: string
          description: Data field name for the column
        name:
          type: string
          description: Column identifier name (e.g. name, sku, on_hand, sold)
        visible:
          type: boolean
          description: Whether the column is visible
      required:
        - name
    InventoryTableOrderSpec:
      type: object
      properties:
        column:
          type: number
          description: Index of the column to sort by
        dir:
          type: string
          enum:
            - asc
            - desc
          description: Sort direction
      required:
        - column
    InventoryTableFilters:
      type: object
      properties:
        warehouses:
          type: array
          items:
            type: string
          description: Warehouse IDs to filter by
        stores:
          type: array
          items:
            type: string
          description: Store IDs to filter by
        movers:
          type: array
          items:
            type: string
            enum:
              - fast
              - medium
              - slow
              - dead
          description: Mover categories to filter by
        show_unsold_items:
          type: boolean
          description: Whether to include items with no sales
        show_inactive_items:
          type: boolean
          description: Whether to include inactive items
        show_stocked_items:
          type: boolean
          description: Whether to include stocked items
        show_unstocked_items:
          type: boolean
          description: Whether to include items with no stock
        distributors:
          type: array
          items:
            type: string
          description: Distributor IDs to filter by
        order_tags:
          type: array
          items:
            type: string
          description: >-
            Order tag IDs to filter velocity data by (ObjectId strings
            referencing the tag collection)
          example:
            - 507f1f77bcf86cd799439011
      description: Filter criteria for the table
    InventoryTableRange:
      type: object
      properties:
        start:
          type: string
          description: Start date for velocity range
          example: '2025-01-01T00:00:00.000Z'
        end:
          type: string
          description: End date for velocity range
          example: '2025-01-31T23:59:59.000Z'
      required:
        - start
        - end
      description: Date range for velocity table type
  securitySchemes:
    SKULabsToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````