# Farmersfridge — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Farmer's Fridge menu data, product details, kiosk locations, and real-time inventory. Browse the full menu or filter by category, retrieve nutrition facts and allergens for individual products, list kiosk locations by access or location type, and check live stock counts at any specific fridge.

**Category:** Food & Dining | **Website:** [farmersfridge.com/](https://farmersfridge.com/) | **Docs:** [parse.bot/marketplace/b47cf09b-12ef-4cc9-b98b-8436215ae5f1/farmersfridge-com-api](https://parse.bot/marketplace/b47cf09b-12ef-4cc9-b98b-8436215ae5f1/farmersfridge-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get location menu

Returns the real-time available menu for a specific fridge location, including prices (in cents), stock counts, ingredients, and allergens for each item. The fridgeId is obtained from get_locations results. Paginates as a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fridge_id` | string | Yes | The fridgeId identifier for a location (e.g. 'TX_DAL_DFW_A21_LEFT'). Obtain from get_locations results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-location-menu \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"fridge_id":"<string>"}'
```

### Get location types

Returns the available fridge location types and access types, which can be used as filter values for get_locations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-location-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get locations

Returns all Farmer's Fridge kiosk locations, optionally filtered by access type and/or location type. Each location includes its fridgeId (used for get_location_menu), address, coordinates, and operating hours. Paginates as a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `access_type` | string | No | Filter by access type. |
| `location_type` | string | No | Filter by location type. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"access_type":"<string>","location_type":"<string>"}'
```

### Get menu

Returns all products on the general menu, optionally filtered by category. Each product includes basic info (name, SKU, calories, image). Use get_product_details for full nutrition and ingredient data. Paginates as a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter by menu category name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-menu \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get menu categories

Returns the list of all available menu categories. Use these values to filter get_menu results by category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-menu-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get product at location

Returns product availability, price (in dollars), and stock count at a specific fridge location. Returns stale_input with kind input_not_found if the product is not stocked at the specified fridge.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fridge_id` | string | Yes | The fridgeId identifier for a location (e.g. 'TX_DAL_DFW_A21_LEFT'). Obtain from get_locations results. |
| `slug` | string | Yes | Product slug (e.g. 'steakhouse-chopped-salad'). Obtain from get_menu results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-product-at-location \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"fridge_id":"<string>","slug":"<string>"}'
```

### Get product details

Returns full details for a single product by its slug, including nutrition facts, allergens, ingredients broken into components, and image URLs. The slug is obtained from get_menu results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug from the menu endpoint (e.g. 'steakhouse-chopped-salad'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farmersfridge/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.