---
title: "List Jobs"
method: GET
path: "/v0/workflows/{workflow_id}/jobs"
tags: ["Jobs"]
---

# List Jobs

`GET /v0/workflows/{workflow_id}/jobs`

## Request

- Base URL: `https://api.pixxel.space`
- URL: `https://api.pixxel.space/v0/workflows/{workflow_id}/jobs`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pixxel/apis/stargate/docs/v0/workflows/:workflow_id/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

List Jobs for a given workflow id

## Path parameters

- `workflow_id` string, required

## Query parameters

- `id` string
- `status` string
- `created_by` string
- `created_on` string

## Response `200`

OK

- DexterListJobsTransformerResponse
  - `jobs` DexterListJobsItem[]
    - `created_by` string: ID of the user who created the job
    - `id` string: unique identifier for the job
    - `cost` integer: cost of the job
    - `workflow_id` string: unique identifier of the workflow the job belongs to
    - `created_at` string: timestamp when the job was created
    - `updated_at` string: timestamp when the job was last updated
    - `finished_at` string: timestamp when the job was completed
    - `estimated_duration` integer: expected time to complete the job in seconds
    - `progress` string: current completion percentage of the job
    - `status` string: current state of the job
    - `time_taken` string: actual duration the job took to complete

## Other responses

- `400`: Bad Request
- `403`: Forbidden

---

[API](https://skmtc.dev/pixxel/apis/stargate.md) - [All operations](https://skmtc.dev/pixxel/apis/stargate/llms.txt) - [OpenAPI document](https://skmtc.dev/pixxel/apis/stargate/revisions/519562bd9d7a?raw)