---
title: "List recipes"
method: GET
path: "/recipes"
---

# List recipes

`GET /recipes`

## Request

- Base URL: `https://api.bannerbear.com/v5`
- URL: `https://api.bannerbear.com/v5/recipes`
- Auth: HTTP bearer

Recipes are ready-made workflows in the public library, each with a sample run that shows its inputs and outputs. Newest first, 20 per page.

## Query parameters

- `page` integer
- `q` string
- `audience` string

## Response `200`

Paginated list of recipes

- object[]
  - `uid` string
  - `slug` string
  - `name` string
  - `description` string, nullable
  - `tags` string[]
  - `categories` string[]
  - `audiences` string[]
  - `preview` string, uri, nullable: Preview image or gif URL
  - `sample` object: An example run of the recipe
    - `inputs` object[]
      - `label` string
      - `kind` 'image' | 'audio' | 'file' | 'text': How to show the value. For a list, the kind of its items.
      - `value` union: A URL or text, or a list of URLs when the output has several files
        - string
        - string[]
      - `thumbnail` string, uri: An image of the first page, on a PDF file only
    - `outputs` object[]
      - `label` string
      - `kind` 'image' | 'audio' | 'file' | 'text': How to show the value. For a list, the kind of its items.
      - `value` union: A URL or text, or a list of URLs when the output has several files
        - string
        - string[]
      - `thumbnail` string, uri: An image of the first page, on a PDF file only
    - `credits` object
      - `api` integer, nullable: API credits the example used
      - `ai` number, nullable: AI credits the example used
  - `install_count` integer
  - `published_at` string, date-time, nullable
  - `created_at` string, date-time

## Changes

- **2026-11-10** `24e6335e0a47`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/changes/recipes/get.md)

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) - [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/revisions/357256cbd1e5?raw)