---
title: "Get Run Trace"
method: GET
path: "/api/v1/runs/{run_id}/trace"
tags: ["runs"]
---

# Get Run Trace

`GET /api/v1/runs/{run_id}/trace`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/runs/{run_id}/trace`
- Auth: none declared

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- RunTraceRead: Per-task request/response trace surface — BRIEF-001 §6 IN-5. Returned from GET /runs/{id}/trace and rendered inline on the run-detail page so the customer can verify the score is real (Customer Voice §1 quote: "I told you it's a RAG bot and you ran FizzBuzz on it"). Headers are redacted server-side — the caller never sees the bearer token they configured on the agent. Free tier sees this exact shape. Pro adds export — handled at the paywall layer in a follow-up brief (§4 trace-as-Pro wedge), not here. The minimum-viable trace is non-negotiable per §6 IN-5.
  - `run_id` string, uuid, required
  - `task_id` string, uuid, required
  - `agent_id` string, uuid, required
  - `request_url` string, nullable
  - `has_request_url` boolean
  - `request_method` string
  - `request_headers` object, nullable
  - `request_body` union
    - object
    - unknown[]
      - unknown
    - string
  - `response_status` integer, nullable
  - `response_body` unknown
  - `latency_ms` integer, nullable
  - `retry_count` integer
  - `error_class` string, nullable
  - `error_message` string, nullable
  - `parsed_output` string, nullable
  - `expected_output` string, nullable
  - `success` boolean, nullable
  - `answer_exposed` boolean
  - `task_name` string, nullable
  - `task_prompt` string, nullable
  - `prompt_available` boolean
  - `evaluation_method` string
  - `expected_output_shape` 'reference_text' | 'non_empty_text'
  - `evaluation_result` 'passed' | 'failed' | 'pending'
  - `evaluation_reason` string, nullable

## 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)