Skip to main content
GET
/
api
/
v1
/
agents
List Agents
curl --request GET \
  --url https://api.example.com/api/v1/agents
{
  "agents": [
    {
      "agent_name": "<string>",
      "display_name": "<string>",
      "message_count": 123,
      "last_active": "<string>",
      "total_cost": 123,
      "total_tokens": 123,
      "sparkline": [
        {}
      ]
    }
  ]
}
Retrieves all active agents for the authenticated user, along with their usage statistics and activity sparklines.

​
Response

​
agents
array
Array of agent objects with usage statistics

​
Example Request

curl https://api.manifest.build/api/v1/agents \
  -H "Cookie: better-auth.session_token=YOUR_SESSION_TOKEN"

​
Example Response

{
  "agents": [
    {
      "agent_name": "my-agent",
      "display_name": "My Agent",
      "message_count": 1234,
      "last_active": "2026-03-04T12:34:56.789Z",
      "total_cost": 5.67,
      "total_tokens": 45000,
      "sparkline": [100, 150, 200, 180, 220, 190, 210, 230, 240, 220, 200, 180, 190, 210, 230, 240, 250, 260, 240, 220, 200, 180, 190, 200]
    },
    {
      "agent_name": "another-agent",
      "display_name": "Another Agent",
      "message_count": 567,
      "last_active": "2026-03-03T08:20:15.123Z",
      "total_cost": 2.34,
      "total_tokens": 18000,
      "sparkline": [50, 75, 100, 90, 110, 95, 105, 115, 120, 110, 100, 90, 95, 105, 115, 120, 125, 130, 120, 110, 100, 90, 95, 100]
    }
  ]
}

​
Notes

  • Agents are ordered by creation date (newest first)
  • Only active agents are returned
  • Sparklines show hourly token usage over the last 7 days, downsampled to 24 data points
  • Statistics are calculated across all messages for each agent

Build docs developers (and LLMs) love

Get started for freeTalk to us