# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-farmersfridge-com-api-b47cf09b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-farmersfridge-com-api-b47cf09b/get_location_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-farmersfridge-com-api-b47cf09b/get_location_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-farmersfridge-com-api-b47cf09b/get_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-farmersfridge-com-api-b47cf09b/get_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-farmersfridge-com-api-b47cf09b/get_menu_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-farmersfridge-com-api-b47cf09b/get_product_at_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-farmersfridge-com-api-b47cf09b/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```