---
title: "Retrieve a workflow's successful jobs"
method: GET
path: "/root/{m-wf-id}/workflow/{wf-id}/job/successful"
tags: ["Job"]
---

# Retrieve a workflow's successful jobs

`GET /root/{m-wf-id}/workflow/{wf-id}/job/successful`

## Request

- Base URL: `https://localhost:5000/api/v1/user/unknown`
- URL: `https://localhost:5000/api/v1/user/unknown/root/{m-wf-id}/workflow/{wf-id}/job/successful`
- Auth: none declared
- TypeScript: <https://skmtc.dev/pegasus-isi/apis/monitoring-api/docs/root/:m-wf-id/workflow/:wf-id/job/successful/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a collection of successful Job resource.
Note: Queries, Sorting can include fields from Job and JobInstance resource

## Query parameters

- `query` string
- `order` string
- `start-index` integer
- `max-results` integer

## Response `200`

Success

- Job[]
  - `job_id` integer
  - `exec_job_id` string
  - `submit_file` string
  - `type_desc` string
  - `max_retries` integer
  - `clustered` boolean
  - `executable` string
  - `argv` string
  - `task_count` integer

## Other responses

- `204`: No content
- `400`: Bad request
- `401`: Not authenticated
- `403`: Not authorized
- `default`: Internal server error

## Changes

- **2026-07-17** `0f83c09a8c4a`: 1 info
  - endpoint added
- **2020-06-03** `7d29411eaad7`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/pegasus-isi/apis/monitoring-api/changes/root/:m-wf-id/workflow/:wf-id/job/successful/get.md)

---

[API](https://skmtc.dev/pegasus-isi/apis/monitoring-api.md) - [All operations](https://skmtc.dev/pegasus-isi/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pegasus-isi/apis/monitoring-api/revisions/0f83c09a8c4a?raw)