---
title: "Get a combined report across results"
method: GET
path: "/test_framework/v2/results/reports/"
tags: ["Results"]
---

# Get a combined report across results

`GET /test_framework/v2/results/reports/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v2/results/reports/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer
  - API key in header `X-VOCERA-SHAREABLE-LINK-TOKEN`
  - HTTP bearer

Aggregate two or more test results into a single report: overall success rate, per-metric summary, run counts, critical categories, per-tag success rates, response-latency percentiles, deduplicated failure reasons and combined cost/duration figures.

Find the result IDs with `results_list` first. Passing a single ID is allowed but `results_retrieve` is the better tool for one result.

Leave `ql` at its default `{-runs}`. Selecting runs embeds every run of every result in the response; fetch the runs you actually need with `runs_bulk_retrieve` instead.

## Query parameters

- `result_ids` string, required
- `run_filters` string
- `ql` string
- `agent_id` integer
- `assistant_id` string
- `project_id` integer

## Response `200`

- SchemaCombinedResultsReport
  - `status` string, required: Always 'completed' — the report is computed on read, not queued.
  - `success_rate` number, double, required: Percentage of runs that passed, across every result in the report
  - `total_runs_count` integer, required: Runs in the report, including those still executing
  - `completed_runs_count` integer, required: Runs that reached a terminal state (completed, failed, timeout or cancelled)
  - `success_runs_count` integer, required: Completed runs that passed
  - `failed_runs_count` integer, required: Completed runs that failed
  - `agent` integer, required: ID of the agent the results belong to
  - `agent_version` unknown, required
  - `overall_evaluation` unknown, required
  - `metrics` unknown, required
  - `critical_categories` unknown, required
  - `runs_by_tags` unknown, required
  - `latency_data` unknown, required
  - `failed_reasons` unknown, required
  - `performance_metrics` unknown, required
  - `runs` unknown

## Other responses

- `400`

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v2/results/reports/get.md)

---

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