Skip to content

Get all Stage Runs for the Pipeline Run
Stable

Request

Retrieves all Stage Runs for a specific Pipeline Run.

Returns the stage-level execution records for the specified pipeline run, showing the status of each stage as the pipeline progressed.

About Stage Runs A Stage Run is the execution instance of one Stage within a Pipeline Run. Since pipelines execute in ordered stages, this endpoint is the primary way to see how far a run has progressed and where it may have stalled or failed.

Key Fields / Query Parameters

  • pipeline_run_id — UUID of the Pipeline Run to list Stage Runs for
  • status — Optional filter to narrow results to Stage Runs in a specific status
Security
pipelines_SCAPIAuthToken
Path
pipeline_run_idstringrequired

ID of the Pipeline Run

Query
statusstring

Status of stage run

Enum:"pending""queued""processing""running""complete""success""failure""cancelled""invalid""timeout"
cURL
curl -i -X GET \
  'https://develop-api.esper.io/_mock/openapi/pipelines/v0/runs/{pipeline_run_id}/stageruns/?status=pending' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

All Stage Runs for the Pipeline Run

Bodyapplication/json
codeinteger
messagestring
contentobject
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "count": 0,
    "previous": "string",
    "next": "string",
    "results": [ … ]
  }
}