> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Look up published recipe

> Finds the currently published recipe for a product/variant/service combination.

<ParamField header="x-api-key" type="string" required>
  BOH API key with `recipes:read` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField query="external_product_id" type="string">
  Your POS product ID.
</ParamField>

<ParamField query="external_variant_id" type="string">
  Your POS variant ID.
</ParamField>

<ParamField query="store_id" type="string">
  BOH store UUID.
</ParamField>

<ParamField query="service_code" type="string">
  Service/channel code (e.g. `DELIVERY`, `DINE_IN`).
</ParamField>

<ResponseField name="id" type="string">Recipe UUID.</ResponseField>
<ResponseField name="recipe_type" type="string">Recipe type.</ResponseField>
<ResponseField name="status" type="string">`PUBLISHED`.</ResponseField>
<ResponseField name="recipe_name" type="string">Display name.</ResponseField>
<ResponseField name="recipe" type="object">Recipe content with lines.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "rec_01j5k...",
    "recipe_type": "SALES_RECIPE",
    "status": "PUBLISHED",
    "version": 2,
    "recipe_name": "Classic Burger",
    "external_product_id": "prod-burger-001",
    "recipe": {
      "lines": [
        {
          "consume_by": "ITEM",
          "item_id": "itm_beef_01...",
          "qty_base": 180,
          "base_unit_id": "unit_g_01..."
        }
      ]
    },
    "published_at": "2026-08-01T10:00:00.000Z"
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "kind": "recipe_not_found",
      "message": "No published recipe found for the given parameters"
    }
  }
  ```
</ResponseExample>