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

# List Tools

> Retrieve a list of all module instances for the authenticated user's company



## OpenAPI

````yaml GET /module/instance/list
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /module/instance/list:
    get:
      summary: List Module Instances
      description: >-
        Retrieve a list of all module instances for the authenticated user's
        company
      responses:
        '200':
          description: List of module instances retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ModuleInstanceSummary'
        '401':
          description: Unauthorized - Invalid or missing API key
      security:
        - CompanyApiKey: []
components:
  schemas:
    ModuleInstanceSummary:
      type: object
      properties:
        id:
          type: string
          description: Module instance ID
        icon:
          type: string
          description: Icon URL
        status:
          type: string
          enum:
            - active
            - running
            - error
          description: Status based on most recent module run
        instance_name:
          type: string
          description: Instance name
        description:
          type: string
          description: Module description
        activation_type:
          type: string
          description: How the module is activated
        custom_params:
          type: object
          description: Custom parameters
        variables:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              description:
                type: string
              type:
                type: string
              required:
                type: boolean
              preset:
                type: boolean
  securitySchemes:
    CompanyApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: Company API Key

````