---
title: "Get detailed feedback metrics for an agent"
method: GET
path: "/api/agents/{agentId}/feedback-metrics"
tags: ["Agent Runs"]
---

# Get detailed feedback metrics for an agent

`GET /api/agents/{agentId}/feedback-metrics`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/agents/{agentId}/feedback-metrics`
- Auth: HTTP bearer

Retrieves comprehensive feedback metrics for a single agent including time-series data, per-prompt breakdown (optional), and all-time statistics

## Path parameters

- `agentId` string, uuid, required

## Query parameters

- `groupByPrompt` string

## Response `200`

Successful response

- object
  - `agentId` string, uuid, required
  - `avgScore7d` number, nullable, required
  - `avgScore30d` number, nullable, required
  - `upRate7d` number, nullable, required
  - `upRate30d` number, nullable, required
  - `total7d` integer, required
  - `total30d` integer, required
  - `series30d` object[], required
    - `date` string, required
    - `avgScore` number, required
    - `upRate` number, nullable, required
    - `count` integer, required
  - `byPrompt` object[]
    - `agentVersionId` string, uuid, nullable, required
    - `description` string, nullable, required
    - `status` 'active' | 'previous' | 'null', nullable, required
    - `avgScoreAllTime` number, nullable, required
    - `upRateAllTime` number, nullable, required
    - `totalAllTime` integer, required
    - `avgScore7d` number, nullable, required
    - `upRate7d` number, nullable, required
    - `total7d` integer, required
    - `avgScore30d` number, nullable, required
    - `upRate30d` number, nullable, required
    - `total30d` integer, required
  - `avgScoreAllTime` number, nullable, required
  - `upRateAllTime` number, nullable, required
  - `totalAllTime` integer, required

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `401`: Unauthorized — missing or invalid API key / session
- `403`: Forbidden — the authenticated user lacks the required permissions
- `500`: Internal server error

---

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