---
title: "List Egress Top Agents Rollup"
method: GET
path: "/api/v1/edges/egress/top-agents"
tags: ["Edge"]
---

# List Egress Top Agents Rollup

`GET /api/v1/edges/egress/top-agents`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/edges/egress/top-agents`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Lists agents ranked by MCP request count across the Edges the caller manages.

## Query parameters

- `page_size` integer: The pageSize field.
- `since` string, int64: The since field.
- `until` string, int64: The until field.

## Response `200`

Successful response

- C1ApiEdgeV1EdgeServiceListEgressTopAgentsRollupResponse: The EdgeServiceListEgressTopAgentsRollupResponse message.
  - `agents` C1ApiEdgeV1TBTopAgent[], nullable: Ordered by call_count descending, limited to page_size. No pagination cursor -- this is a fixed top-N, not a full list.
    - `allowedCount` string, uint64: The allowedCount field.
    - `callCount` string, uint64: The callCount field.
    - `deniedCount` string, uint64: The deniedCount field.
    - `requestBytes` string, uint64: request_bytes is sum(counter_request_bytes) -- bytes the agent sent out.
    - `responseBytes` string, uint64: The responseBytes field.
    - `sourcePrincipal` string: The sourcePrincipal field.
    - `sourcePrincipalKind` string: The sourcePrincipalKind field.
  - `edgeCount` integer: Number of authorized Edges included. Zero means the caller manages no Edges, as distinct from Edges that have no traffic yet.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/edges/egress/top-agents/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)