# Search agents
Source: https://docs.simpleserve.ai/docs/api-reference/agents/get-agents

Method: GET /v1/agents
Base URL: https://api.simpleserve.ai

```json
{
  "path": "/v1/agents",
  "method": "GET",
  "tags": [
    "Agents"
  ],
  "operationId": "listAgents",
  "summary": "Search agents",
  "description": "Returns agents available to the current account. Search matches agent\nnames, descriptions, categories, and supported work.\n",
  "parameters": [
    {
      "$ref": "#/components/parameters/SearchQuery"
    },
    {
      "$ref": "#/components/parameters/CategoryFilter"
    },
    {
      "$ref": "#/components/parameters/OutputTypeFilter"
    },
    {
      "$ref": "#/components/parameters/Limit"
    },
    {
      "$ref": "#/components/parameters/Cursor"
    }
  ],
  "responses": {
    "200": {
      "description": "A page of agents.",
      "headers": {
        "x-request-id": {
          "$ref": "#/components/headers/RequestId"
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AgentList"
          },
          "examples": {
            "default": {
              "$ref": "#/components/examples/AgentListExample"
            }
          }
        }
      }
    },
    "400": {
      "$ref": "#/components/responses/BadRequest"
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    },
    "429": {
      "$ref": "#/components/responses/RateLimited"
    },
    "500": {
      "$ref": "#/components/responses/InternalError"
    }
  }
}
```