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

# Get Pipeline Status

`GET /pipeline/{session_id}/status`

Get pipeline execution status with detailed progress.

Uses the same merged disk+bus view as ``/sessions/{sid}`` so the two
endpoints agree on every observable field for the same session, even
when the executor's outer exception handler persists a terminal disk
status without emitting a corresponding bus event.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- PipelineStatus — 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
  - `error` string, nullable — Sanitized top-level error message (failed runs)
  - `failed_step` string, nullable — Step that failed (only set when status=failed)
  - `failed_step_stats` object, nullable — Structured failed-step stats including any per-unit ``errors`` and ``textures_failed`` count. Mirrors the SSE FAILED event extra so polling clients see the same diagnostic detail.
  - `texture_plan` TexturePlanStatus — Compact immutable-plan summary embedded in polling responses.
    - `schema_version` string, required
    - `decision_state` string, required
    - `execution_allowed` boolean, required
    - `counts` object, required
    - `limits` object, required
    - `plan_url` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-21** `90f9a177effa` — 2 info
  - added the optional property `error` to the response with the `200` status
  - added the optional property `texture_plan` to the response with the `200` status
- **2026-04-30** `f1aa452697e3` — 2 info
  - added the optional property `failed_step` to the response with the `200` status
  - added the optional property `failed_step_stats` to the response with the `200` status
- **2026-04-29** `12695b6a0290` — 2 warning
  - removed the optional property `failed_step` from the response with the `200` status
  - removed the optional property `failed_step_stats` from the response with the `200` status

[Change history](https://skmtc.dev/nvidia/apis/texture-agent-service/changes/pipeline/:session_id/status/get.md)

---

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