---
title: "List Agent Screening Sessions"
method: GET
path: "/api/v1/agents/{agent_id}/screening-sessions"
tags: ["screening-sessions"]
---

# List Agent Screening Sessions

`GET /api/v1/agents/{agent_id}/screening-sessions`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/agents/{agent_id}/screening-sessions`
- Auth: none declared

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- PaginatedResponseScreeningSessionRead
  - `items` ScreeningSessionRead[], required
    - `id` string, uuid, required
    - `agent_id` string, uuid, required
    - `selection_mode` 'suite' | 'custom' | 'catalogue', required
    - `suite_id` string, uuid, nullable, required
    - `label` string, required
    - `trigger` 'user' | 'api_key' | 'schedule' | 'system', required
    - `trigger_label` string, nullable, required
    - `repeats` integer, required
    - `task_count` integer, required
    - `run_count` integer, required
    - `status` 'pending' | 'running' | 'completed' | 'partial_failed' | 'failed', required
    - `passed_count` integer, required
    - `failed_count` integer, required
    - `total_cost_usd` number, nullable
    - `latency_p50_ms` integer, nullable
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `task_plan` ScreeningTaskPlanRead[], required
      - `task_id` string, uuid, required
      - `title` string, required
      - `domain` string, required
      - `difficulty` string, required
      - `prompt` string, nullable
      - `prompt_available` boolean, required
      - `evaluator_id` string, required
      - `expected_output_shape` 'reference_text' | 'non_empty_text', required
      - `timeout_seconds` integer, required
    - `duration_ms` integer, nullable, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `pages` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)