---
title: "Get Available Swarm Types"
method: GET
path: "/v1/swarms/available"
tags: ["Swarms"]
---

# Get Available Swarm Types

`GET /v1/swarms/available`

## Request

- Base URL: `https://api.swarms.world`
- URL: `https://api.swarms.world/v1/swarms/available`
- Auth: none declared. Required headers: `x-api-key`

Retrieve all available swarm types supported by the Swarms API.

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- SwarmTypesOutput: 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.
  - `status` boolean: Indicates whether fetching swarm types was successful.
  - `timestamp` string: The ISO formatted timestamp when this response was generated.
  - `swarm_types` string[]: A list of supported swarm type names.
  - `swarm_types_metadata` SwarmTypeMetadata[]: Rich metadata for every swarm type: description, category, best-for use cases, tuning parameters and documentation link.
    - `swarm_type` string, required: The identifier to pass in the `swarm_type` field of a swarm request.
    - `name` string, required: Human-readable display name for the architecture.
    - `description` string, required: What the architecture does and how it orchestrates its agents.
    - `category` string, required: High-level grouping, e.g. "workflow", "collaboration", "routing", "judgment" or "auto".
    - `best_for` string[]: Representative use cases and workflow types the architecture is best suited for.
    - `parameters` string[]: Swarm-type specific SwarmSpec fields that tune this architecture, beyond the common ones (agents, task, max_loops).
    - `documentation_url` string, nullable: Link to the architecture's documentation page, if one exists.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `500c79520e41`: 1 warning, 8 info
  - removed the optional property `success` from the response with the `200` status
  - api tag `Swarms` added
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - …5 more

[Operation history](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/changes/v1/swarms/available/get.md)

---

[API](https://skmtc.dev/the-swarm-corporation/apis/swarms-api.md) - [All operations](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/revisions/fca99f497199?raw)