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

# List job recipe runs

`GET /v1/recipes/jobs/runs`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/recipes/jobs/runs`
- Auth: API key in header `x-api-key`

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
    - `outcome` 'completed' | 'canceled' | 'job_unavailable' | 'login_required' | 'application_refused' | 'blocked_by_site' | 'invalid_input' | 'insufficient_credits' | 'incomplete' | 'failed', required
    - `next_step` string, nullable, required: What to do about an unsuccessful outcome; null for completed, canceled, and running runs.
  - `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-10-08** `04df18172f4d`: 1 info
  - endpoint added

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

---

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