---
title: "Agents analytics roll-up"
method: GET
path: "/business/analytics/agents"
tags: ["Analytics"]
---

# Agents analytics roll-up

`GET /business/analytics/agents`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/analytics/agents`
- Auth: HTTP basic

Signal-agent (watcher) performance for the token owner's team, proxied from the agents service: totals (agents, active agents, prospects found split into people and companies), a breakdown by agent kind and list type, a breakdown by agent status (active, paused, initializing, expired, ...) and the zero-filled prospects-found series (daily buckets for 7d, ISO-week buckets for 30d and 90d; each point's date is its bucket's start date as a display label ('Jan 1') with the same date as YYYY-MM-DD in isoDate). Only agents created inside the window are counted, together with the prospects those agents delivered. `byType[].monitorType` is the engine's own agent slug and is coarser than the `type` used to create agents: several slugs map to one public type. Rate limit: 20 requests per minute, 1000 per day.

Errors:
- `422` `VALIDATION_FAILED` — `range` was sent and is not one of 7d, 30d or 90d.
- `429` `RATE_LIMITED` — Per-user quota for this endpoint family exceeded (20 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds.

Requires one of the following token scopes: analytics.

## Query parameters

- `range` '7d' | '30d' | '90d': Rolling window ending now: 7d, 30d (default) or 90d, i.e. the roll-up covers the last 7, 30 or 90 days; time-series bucket sizes (daily, weekly, monthly) are chosen from the window length.
- `timezone` string: IANA timezone name (e.g. `Europe/Kyiv`, `America/New_York`) whose calendar days the time series is bucketed by: each bucket's `isoDate` / `date` is a local day, week, month or quarter in this zone. Offsets such as `+03:00` are rejected. Default: `UTC`.

## Response `200`

Success

- object
  - `range` '7d' | '30d' | '90d', required
  - `agents` object, required
    - `totals` object, required
      - `totalAgents` integer, required
      - `activeAgents` integer, required
      - `totalProspects` integer, required
      - `peopleProspects` integer, required
      - `companyProspects` integer, required
    - `byType` object[], required
      - `monitorType` string, required
      - `listType` 'people' | 'company', required
      - `agentCount` integer, required
      - `prospects` integer, required
      - `maxContacts` integer, required
    - `byStatus` object[], required
      - `status` 'active' | 'paused' | 'expired' | 'processing' | 'failed' | 'deleted' | 'initializing', required
      - `count` integer, required
    - `prospectsOverTime` object[], required
      - `date` string, required
      - `isoDate` string, required
      - `people` integer, required
      - `companies` integer, required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)