---
title: "List job recipe runs"
method: GET
path: "/v1/recipes/jobs/runs"
tags: ["Recipes"]
---

# List job recipe runs

`GET /v1/recipes/jobs/runs`

List workflow runs started by job recipe requests.

## Query parameters

- `page` integer — Page number.
- `page_size` integer — Number of runs per page.

## Response `200`

Successful Response

- JobRecipeRunListResponse
  - `runs` JobRecipeRunSummary[], required
    - `workflow_run_id` string, required
    - `workflow_permanent_id` string, required
    - `recipe` 'apply' | 'extract', required
    - `status` string, required
    - `created_at` string, date-time, required
    - `job_url` string, nullable, required
    - `failure_reason` string, nullable, required
  - `page` integer, required
  - `page_size` integer, required
  - `has_next` boolean, required

## Other responses

- `403` — Unauthorized or insufficient organization permission
- `422` — Invalid pagination parameters

## Changes

- **2026-09-14** `4da39b4c8f5f` — 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Recipes` added
  - api tag `Runs` removed
- **2026-09-09** `b090d5083c5b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/recipes/jobs/runs/get.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/72444290d742?raw)