---
title: "Runs per agent (radar, forge, recon, outreach, sentinel, amplify, social) in the window, newest first, each with startedAt, completedAt, status and triggeredBy. sinceDays sets the window (default 30); every run in it is listed, up to 300 per agent, and perAgent caps that lower. Agents with no runs in the window are left out."
method: GET
path: "/api/v1/reports/agent-activity"
---

# Runs per agent (radar, forge, recon, outreach, sentinel, amplify, social) in the window, newest first, each with startedAt, completedAt, status and triggeredBy. sinceDays sets the window (default 30); every run in it is listed, up to 300 per agent, and perAgent caps that lower. Agents with no runs in the window are left out.

`GET /api/v1/reports/agent-activity`

## Request

- Base URL: `https://api.rctrl.com`
- URL: `https://api.rctrl.com/api/v1/reports/agent-activity`
- Auth: HTTP bearer

Requires the `read:analytics` scope.

## Query parameters

- `perAgent` number: Runs per lane, default every run in the window (at most 300)
- `sinceDays` number: Window in days, default 30

## Response `200`

Success; the payload is wrapped in a data envelope

- object
  - `data` unknown

## Other responses

- `400`: Bad input
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope
- `404`: Not found in this workspace
- `429`: Rate limited; the body includes a retryAfterMs hint

---

[API](https://skmtc.dev/rctrl/apis/rankcontrol-api.md) · [All operations](https://skmtc.dev/rctrl/apis/rankcontrol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rctrl/apis/rankcontrol-api/revisions/98ecd236394a?raw)