---
title: "List recipe runs"
method: GET
path: "/orgs/{organization}/recipes/{recipe}/runs"
tags: ["Recipes"]
---

# List recipe runs

`GET /orgs/{organization}/recipes/{recipe}/runs`

## Request

- Base URL: `https://forge.laravel.com/api`
- URL: `https://forge.laravel.com/api/orgs/{organization}/recipes/{recipe}/runs`
- Auth: OAuth 2
  - Authorization code: `https://forge.laravel.com/oauth/authorize`
  - Token URL: `https://forge.laravel.com/oauth/token` scopes: `recipe:view`
- TypeScript: <https://skmtc.dev/mfullbrook/apis/forge/docs/orgs/:organization/recipes/:recipe/runs/get.ts> (a function with typed inputs; its response is checked against the schema)

Show all runs for the recipe.

Processing mode: <small><code>sync</code></small>

## Path parameters

- `organization` string, required
- `recipe` integer, required

## Query parameters

- `page[size]` integer
- `page[cursor]` string

## Response `200`

Paginated set of `RecipeLogResource`

- object
  - `data` RecipeLogResource[], required
    - `id` string, required
    - `type` 'recipeLogs', required
    - `attributes` object
      - `server_id` integer, required
      - `executed_by` integer, nullable, required
      - `recipe_id` integer, required
      - `status` 'waiting' | 'running' | 'finished' | 'failed', required
      - `output` string, nullable, required
      - `started_at` string, date-time, nullable, required
      - `finished_at` string, date-time, nullable, required
    - `links` object, required
      - `self` Link, required
        - `href` string, uri, required
        - `rel` string
        - `describedby` string
        - `title` string
        - `type` string
        - `hreflang` union
          - string
          - string[]
        - `meta` object
  - `links` object, required
    - `first` string
    - `last` string
    - `prev` string
    - `next` string
  - `meta` object, required
    - `path` string, nullable, required: Base path for paginator generated URLs.
    - `per_page` integer, required: Number of items shown per page.
    - `next_cursor` string, nullable, required: The "cursor" that points to the next set of items.
    - `prev_cursor` string, nullable, required: The "cursor" that points to the previous set of items.

## Other responses

- `403`: Authorization error
- `404`: Not found

---

[API](https://skmtc.dev/mfullbrook/apis/forge.md) - [All operations](https://skmtc.dev/mfullbrook/apis/forge/llms.txt) - [OpenAPI document](https://skmtc.dev/mfullbrook/apis/forge/revisions/24ad66d99f93?raw)