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

# Get Available Swarm Types

> Retrieve all available swarm types supported by the Swarms API.



## OpenAPI

````yaml https://api.swarms.world/openapi.json get /v1/swarms/available
openapi: 3.1.0
info:
  title: Swarms API
  description: >-
    Swarms API provides scalable, secure orchestration for multi-agent systems.
    Access robust endpoints for managing agents and swarms, automating
    workflows, and monitoring execution. Requires an API key—see the [API Keys
    page](https://swarms.world/platform/api-keys). Refer to [Swarms API
    Documentation](https://docs.swarms.ai) for guides and details.
  version: 1.0.0
servers:
  - url: https://api.swarms.world
    description: Swarms Production API
security: []
paths:
  /v1/swarms/available:
    get:
      tags:
        - Swarms
      summary: Get Available Swarm Types
      description: Retrieve all available swarm types supported by the Swarms API.
      operationId: check_swarm_types_v1_swarms_available_get
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SwarmTypesOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SwarmTypesOutput:
      properties:
        status:
          type: boolean
          title: Status
          description: Indicates whether fetching swarm types was successful.
          default: true
        timestamp:
          type: string
          title: Timestamp
          description: The ISO formatted timestamp when this response was generated.
          default: '2026-09-24T16:48:09.728132'
        swarm_types:
          items:
            type: string
          type: array
          title: Swarm Types
          description: A list of supported swarm type names.
          default:
            - AgentRearrange
            - MixtureOfAgents
            - SequentialWorkflow
            - ConcurrentWorkflow
            - GroupChat
            - MultiAgentRouter
            - HierarchicalSwarm
            - MajorityVoting
            - CouncilAsAJudge
            - HeavySwarm
            - LLMCouncil
            - DebateWithJudge
            - RoundRobin
            - PlannerWorkerSwarm
        swarm_types_metadata:
          items:
            $ref: '#/components/schemas/SwarmTypeMetadata'
          type: array
          title: Swarm Types Metadata
          description: >-
            Rich metadata for every swarm type: description, category, best-for
            use cases, tuning parameters and documentation link.
      type: object
      title: SwarmTypesOutput
      description: |-
        Response model for supported swarm types.

        Attributes:
            status (bool): Indicates success of the operation.
            timestamp (str): The ISO formatted timestamp of the response.
            swarm_types (List[str]): A list of available swarm type names.
            swarm_types_metadata (List[SwarmTypeMetadata]): Rich metadata for every swarm
                type: description, category, best-for use cases, tuning parameters and docs link.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SwarmTypeMetadata:
      properties:
        swarm_type:
          type: string
          title: Swarm Type
          description: The identifier to pass in the `swarm_type` field of a swarm request.
        name:
          type: string
          title: Name
          description: Human-readable display name for the architecture.
        description:
          type: string
          title: Description
          description: What the architecture does and how it orchestrates its agents.
        category:
          type: string
          title: Category
          description: >-
            High-level grouping, e.g. "workflow", "collaboration", "routing",
            "judgment" or "auto".
        best_for:
          items:
            type: string
          type: array
          title: Best For
          description: >-
            Representative use cases and workflow types the architecture is best
            suited for.
        parameters:
          items:
            type: string
          type: array
          title: Parameters
          description: >-
            Swarm-type specific SwarmSpec fields that tune this architecture,
            beyond the common ones (agents, task, max_loops).
        documentation_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Documentation Url
          description: Link to the architecture's documentation page, if one exists.
      type: object
      required:
        - swarm_type
        - name
        - description
        - category
      title: SwarmTypeMetadata
      description: |-
        Descriptive metadata for a single swarm type (multi-agent architecture).

        Attributes:
            swarm_type (str): The identifier to pass in the `swarm_type` field of a swarm request.
            name (str): Human-readable display name for the architecture.
            description (str): What the architecture does and how it orchestrates its agents.
            category (str): High-level grouping, e.g. "workflow", "collaboration", "routing", "judgment" or "auto".
            best_for (List[str]): Representative use cases and workflow types the architecture suits.
            parameters (List[str]): Swarm-type specific SwarmSpec fields that tune this architecture,
                beyond the common ones (agents, task, max_loops).
            documentation_url (Optional[str]): Link to the architecture's documentation page, if one exists.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

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