---
title: "Get Screening Session"
method: GET
path: "/api/v1/screening-sessions/{session_id}"
tags: ["screening-sessions"]
---

# Get Screening Session

`GET /api/v1/screening-sessions/{session_id}`

## Request

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

## Path parameters

- `session_id` string, uuid, required

## Response `200`

Successful Response

- ScreeningSessionDetailRead
  - `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
  - `runs` ScreeningSessionRunRead[]
    - `id` string, uuid, required
    - `agent_id` string, uuid, required
    - `agent_display_name` string, nullable
    - `agent_identity_state` 'active' | 'deactivated' | 'unavailable', nullable
    - `task_id` string, uuid, required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'timeout', required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `latency_ms` integer, nullable, required
    - `success` boolean, nullable, required
    - `output` string, nullable, required
    - `output_withheld` boolean
    - `error_message` string, nullable, required
    - `input_tokens` integer, nullable, required
    - `output_tokens` integer, nullable, required
    - `total_cost_usd` number, nullable, required
    - `evidence_cost_usd` number, nullable
    - `evidence_cost_source` string
    - `evidence_cost_partial` boolean
    - `evidence_priced_call_count` integer
    - `evidence_unpriced_call_count` integer
    - `evidence_total_call_count` integer
    - `retry_count` integer, required
    - `created_at` string, date-time, required
    - `answer_exposed` boolean
    - `provider_cost_authority` string, nullable
    - `screening_session_id` string, uuid, nullable
    - `repeat_index` integer, nullable
    - `repeat_total` integer, nullable
    - `architecture_hash` string, nullable
    - `previous_architecture_hash` string, nullable
    - `architecture_changed` boolean, nullable
    - `architecture_comparable` boolean
    - `architecture_change_summary` object, nullable
    - `architecture_span_count` integer
    - `certification_id` string, uuid, nullable
    - `certification_sequence` integer, nullable
    - `requested_model` string, nullable
    - `returned_model` string, nullable
    - `llm_provider` string, nullable
    - `usage_source` string, nullable
    - `model_pricing_id` string, uuid, nullable
    - `pricing_input_cost_per_million` number, nullable
    - `pricing_output_cost_per_million` number, nullable
    - `pricing_effective_date` string, date, nullable
    - `error_class` string, nullable
    - `response_status` integer, nullable
    - `error_body_excerpt` string, nullable
    - `execution_mode` string, nullable
    - `verification_hash` string, nullable
    - `signed_at` string, date-time, nullable
    - `key_id` string, nullable
    - `public_certificate_state` 'verified' | 'simulated' | 'unsigned' | 'invalid'
    - `suite_id` string, nullable
    - `suite_version` integer, nullable
    - `model` string, nullable
    - `cost_provenance` string, nullable
    - `cost_basis` 'metered' | 'traced' | 'traced_partial' | 'self_reported' | 'unavailable', nullable
    - `scored_cost_usd` number, nullable
    - `provenance_level` string, nullable
    - `manifest_hash` string, nullable
    - `task_title` string, required
    - `phases` RunPhaseEventRead[]
      - `id` string, uuid, required
      - `run_id` string, uuid, required
      - `sequence` integer, required
      - `phase` string, required
      - `state` 'started' | 'succeeded' | 'failed' | 'unavailable' | 'not_applicable', required
      - `occurred_at` string, date-time, required
      - `duration_since_previous_ms` integer, nullable, required
      - `metadata` object, required
    - `provenance_flags` string[], required
  - `duration_ms` integer, nullable, 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)