---
title: "Retrieve a trace by its ID."
method: GET
path: "/tracer/trace/{id}/"
tags: ["tracer"]
---

# Retrieve a trace by its ID.

`GET /tracer/trace/{id}/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/trace/{id}/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Query params:
- project_id (optional) — the project the trace was opened from.

## Query parameters

- `project_id` string, uuid

## Response `200`

OK

- TraceDetailResponse
  - `status` boolean
  - `result` TraceDetailResult, required
    - `trace` object, required
    - `observation_spans` TraceDetailSpan[], required
      - `observation_span` object, required
      - `children` object[]
      - `eval_scores` object[]: Raw eval rows retained for backwards-compatible array consumers.
      - `eval_rollup` EvalRollup
        - `scope` 'trace' | 'span', required
        - `evals` EvalRollupEval[], required
          - `eval_config_id` string, required
          - `eval_name` string, required
          - `output_type` string, nullable
          - `template_type` string, nullable
          - `target_type` 'span' | 'trace', nullable
          - `choices_map` object, nullable: Any valid JSON value.
          - `aggregate` object, required: Any valid JSON value.
          - `spans` EvalRollupSpan[], required
            - `span_id` string, required
            - `span_name` string
            - `value` object, nullable: Any valid JSON value.
            - `explanation` string, nullable
            - `error` boolean
            - `status` string, nullable
            - `eval_config_id` string
          - `error` boolean
        - `error` boolean
      - `annotations` object[]
    - `summary` object, required
    - `graph` object, required

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)