---
title: "Get Predict Results"
method: GET
path: "/predict/{session_id}/results"
tags: ["predict"]
---

# Get Predict Results

`GET /predict/{session_id}/results`

Get predict execution results (only available when completed). Surfaces
`predictions_count`, `failed_count`, `predictions_path`, and
`token_stats` directly (not buried inside `stats`) so they line up with
the source-of-truth Python `PredictOutput`.

## Path parameters

- `session_id` string, required

## Response `200`

Predict completed successfully.

- union
  - PredictResults — Predict-only execution results.
    - `session_id` string, required
    - `status` string, required
    - `mode` string, required — Detected predict mode: 'dataset_only' or 'full_predict'.
    - `steps_run` string[] — Pipeline steps the predict route actually drove.
    - `stats` object — Execution statistics
    - `predictions_count` integer — Number of predictions produced (from PredictOutput).
    - `failed_count` integer — Number of failed predictions (from PredictOutput).
    - `predictions_path` string, nullable — Server-side path to predictions.jsonl on disk.
    - `token_stats` object — VLM token usage statistics when available.
    - `download_urls` object — URLs to download artifacts (predictions, report, dataset).
    - `duration_seconds` integer, required — Total predict duration in seconds
    - `completed_at` string, required — ISO timestamp when completed
  - PipelineError — Pipeline error response.
    - `session_id` string, required
    - `status` string
    - `error_message` string, required — Stable value-free diagnostic code
    - `failed_step` string, required — Step that failed
    - `completed_steps` string[] — Steps completed before failure
    - `partial_results` object, nullable — Partial results if available

## Other responses

- `202` — Predict still pending or running.
- `404` — Session not found
- `422` — Validation Error

## Changes

- **2026-05-27** `bef81aa36f74` — 1 info
  - endpoint added
- **2026-04-29** `0ba9e71b823c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nvidia/apis/physics-agent-service/changes/predict/:session_id/results/get.md)

---

[API](https://skmtc.dev/nvidia/apis/physics-agent-service.md) · [All operations](https://skmtc.dev/nvidia/apis/physics-agent-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/physics-agent-service/revisions/47f3bc191c91/schema)