Get an Agent summary

curl --request GET \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/summary \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.revoengine.com/api/v1/agents/{agentId}/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/agents/{agentId}/summary"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "activeRunCount": 1,
  "queuedInboxCount": 3,
  "attachedPluginCount": 2,
  "totalRunCount": 14,
  "failedRunCount": 2,
  "blockedRunCount": 1,
  "tokenUsage": {
    "today": 1800,
    "currentBillingPeriod": 28000,
    "previousBillingPeriod": 24000,
    "allTime": 84000,
    "input": 61000,
    "output": 17000,
    "cachedInput": 12000,
    "reasoning": 6000,
    "threadCount": 12
  },
  "tokenUsageByModel": [
    {
      "model": "configured-model",
      "input": 61000,
      "uncachedInput": 49000,
      "cachedInput": 12000,
      "output": 17000,
      "reasoning": 6000,
      "billable": 67200
    }
  ],
  "tokenUsageSeries": [
    {
      "period": "2026-07-13",
      "input": 1200,
      "output": 480,
      "cachedInput": 300,
      "reasoning": 120,
      "toolTokens": 220,
      "billable": 1530
    }
  ],
  "taskActivitySeries": [
    {
      "period": "2026-07-13",
      "created": 0,
      "queued": 1,
      "running": 1,
      "waiting": 0,
      "success": 8,
      "blocked": 1,
      "failure": 2,
      "cancelled": 1,
      "total": 14
    }
  ],
  "lastRun": {
    "agentRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
    "status": "FINISHED"
  },
  "lastFailure": {
    "agentRunId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
    "status": "ERROR"
  },
  "lastBlocked": {
    "agentRunId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
    "status": "ACTION_REQUIRED"
  }
}