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

# List Agents

> Returns all discovered agents with inventory data

Returns every agent in the inventory with their observation counts, tools, maturity status, and framework detection.

### Response

Array of agent objects with the same fields as the [Get Agent Detail](https://docs.tracectrl.ai/api-reference/topology-agent.md) endpoint.

```json 200 theme={"dark"}
[
  {
    "agent_id": "researcher-agent",
    "name": "Researcher",
    "framework": "langchain",
    "role": "Research and analysis",
    "model": "gpt-4o",
    "tools_observed": ["search_documents", "fetch_url"],
    "system_prompt_hash": "a1b2c3d4e5f67890",
    "run_count": 15,
    "observation_count": 234,
    "maturity": "MATURE",
    "first_seen": "2026-03-15T10:30:00Z",
    "last_seen": "2026-03-17T14:22:00Z"
  }
]
```


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