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

# Get Predict Status

`GET /predict/{session_id}/status`

Get predict execution status with detailed progress. Reuses the same response schema as `/pipeline/{id}/status`.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- PipelineStatus — Enhanced pipeline execution status with progress.
  - `session_id` string, required
  - `status` string, required — Current status: pending, running, completed, failed, cancelled, cancelling
  - `current_step` CurrentStepInfo — Information about the currently executing step.
    - `name` string, required — Step internal name
    - `display_name` string, required — Human-readable step name
    - `started_at` string, required — ISO timestamp when step started
    - `progress` StepProgress, required — Progress information for a single step.
      - `current` integer, required — Current progress count
      - `total` integer, required — Total items to process
      - `percent` integer, required — Percentage complete (0-100)
      - `message` string, required — Human-readable progress message
    - `elapsed_seconds` integer, required — Seconds since step started
  - `completed_steps` CompletedStepInfo[]
    - `name` string, required — Step internal name
    - `display_name` string, required — Human-readable step name
    - `started_at` string, required — ISO timestamp when step started
    - `completed_at` string, required — ISO timestamp when step completed
    - `duration_seconds` integer, required — Step duration in seconds
    - `stats` object — Step-specific statistics
  - `overall_progress` OverallProgress, required — Overall pipeline progress.
    - `current_step` integer, required — Current step number (1-indexed)
    - `total_steps` integer, required — Total number of steps
    - `percent` integer, required — Overall percentage complete (0-100)
    - `estimated_remaining_seconds` integer, nullable — Estimated seconds until completion
  - `preview_images` string[] — URLs to preview images
  - `can_cancel` boolean, required — Whether pipeline can be cancelled
  - `elapsed_seconds` integer, required — Total elapsed time in seconds
  - `created_at` string, required — ISO timestamp when session created
  - `updated_at` string, required — ISO timestamp of last update

## Other responses

- `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/status/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)