# Panera Bread API

> Panera Bread cafe menus, menu placards with prices and item customizations

- Vendor: `panerabreadapi` · version 1.0 · category Food · tags panera api, panera bread api, panera menu api, bakery cafe menu api, restaurant menu api, panera prices api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/panerabreadapi
- This document: https://apiclay.com/docs/panerabreadapi.md
- OpenAPI 3.1: https://apiclay.com/api/panerabreadapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `panerabreadapi`
- Updated: 2026-11-18

## About

## Panera Bread API

Read a Panera Bread cafe's menu: the category tree, the menu placards (products with prices and images) and the modifier groups of any item. Every menu call is pinned to version numbers that the `/menu-versions` route returns for the cafe.

Data comes from **panerabread.com** (https://www.panerabread.com). Every route below calls the site's own endpoint directly and returns the upstream response unchanged.

Typical flow: `/menu-versions` -&gt; `/menus` + `/products` -&gt; `/customizations`

The cafe id is Panera's numeric cafe number (e.g. `609331`).

### Routes

#### GET `/menu-versions` - Menu versions (version numbers for a cafe)
Returns the current version numbers of each menu document for the cafe. Pass them to the other routes.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cafe_id | path | string | yes | Panera cafe number, e.g. `609331`. |

Returns (fields read by the source code; not yet verified live):
- `versions.mnavCategory`, `versions.mnavCategorySchedule`, `versions.productCombo`: versions for `/menus`
- `versions.mnavPlacard`, `versions.mnavPlacardSchedule`: versions for `/products`
- `versions.productCustomization`: version for `/customizations`

#### GET `/menus` - Menus (categories of a cafe)
Returns the cafe's category tree with the placard ids in each category.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cafe_id | path | string | yes | Panera cafe number, e.g. `609331`. |
| category_version | path | string | yes | `versions.mnavCategory` from `/menu-versions`. |
| category_schedule_version | path | string | yes | `versions.mnavCategorySchedule` from `/menu-versions`. |
| combo_version | path | string | yes | `versions.productCombo` from `/menu-versions`. |

Returns (fields read by the source code; not yet verified live):
- `navigableCategories[].catId`: top-level category order
- `categoryDict..name`, `.placards[]`, `.subCategories[].catId`: category name, its placard ids and subcategories

#### GET `/products` - Products (menu placards of a cafe)
Returns every placard (menu product card) of the cafe.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cafe_id | path | string | yes | Panera cafe number, e.g. `609331`. |
| placard_version | path | string | yes | `versions.mnavPlacard` from `/menu-versions`. |
| placard_schedule_version | path | string | yes | `versions.mnavPlacardSchedule` from `/menu-versions`. |

Returns (fields read by the source code; not yet verified live):
- `placards..name`, `.description`, `.price`, `.imgKey`: product card details (price in dollars)
- `placards..defaultItemId`: item id, the `item_id` for `/customizations`
- `placards..actionPalette[].options[].itemId`, `.name`, `.price`: size/portion choices
- `placards..availabilityExceptions[].destination`: `rpu` (pickup) or `delivery` when not available

#### GET `/customizations` - Customizations (modifier groups of an item)
Returns the modifier groups and options of one menu item.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cafe_id | path | string | yes | Panera cafe number, e.g. `609331`. |
| customization_version | path | string | yes | `versions.productCustomization` from `/menu-versions`. |
| item_id | path | string | yes | Item id from `/products`, e.g. `780704`. |

Returns (fields read by the source code; not yet verified live):
- `modGroups[].modGroupId`, `.name`, `.minAllowed`, `.maxAllowed`: modifier group and its limits
- `modGroups[].modItems[].modItemId`, `.name`: modifier item
- `modGroups[].modItems[].variants[].itemId`, `.buttonLabel`, `.displayPrice`: variant choices (e.g. Light, Regular, Extra)

### Caveats

- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- The source site uses bot protection (Akamai); calls may be blocked until that is handled.
- These routes were translated from working client code but have not yet been called through ApiClay. Expect adjustments once they are tested.
- Not affiliated with panerabread.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /menu-versions — Menu versions (version numbers for a cafe)
- Gateway: `GET https://api.apiclay.com/v1/api/panerabreadapi/menu-versions`
- Public query params: `cafe_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /menus — Menus (categories of a cafe)
- Gateway: `GET https://api.apiclay.com/v1/api/panerabreadapi/menus`
- Public query params: `cafe_id` (string, required), `category_version` (string, required), `category_schedule_version` (string, required), `combo_version` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /products — Products (menu placards of a cafe)
- Gateway: `GET https://api.apiclay.com/v1/api/panerabreadapi/products`
- Public query params: `cafe_id` (string, required), `placard_version` (string, required), `placard_schedule_version` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /customizations — Customizations (modifier groups of an item)
- Gateway: `GET https://api.apiclay.com/v1/api/panerabreadapi/customizations`
- Public query params: `cafe_id` (string, required), `customization_version` (string, required), `item_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/panerabreadapi/menu-versions?cafe_id=<cafe_id>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
