# Catering & Party API
> Catering and party-planning maths as an API, computed locally and deterministically — the how-much-do-I-buy numbers a host or caterer plans a headcount with. The food endpoint scales a menu to the guest count and appetite: the main protein at about half a pound of cooked meat per person (light 0.33, hearty 0.75), each side dish at roughly four ounces a head, six appetizer pieces each and one-and-a-half dinner rolls — so 50 guests at a standard dinner with three sides need 25 lb of meat, 300 appetizers and 75 rolls. The drinks endpoint sizes the bar: about one drink per guest per hour plus an extra in the first hour, split across beer, wine and cocktails, and converted into the real units you buy — beer by the case (24) and the half-keg (~165 servings), wine by the bottle (~5 glasses), spirits by the 750 ml bottle (~16 shots) — plus the ice (about 1.5 lb per guest) and water; a 50-guest, four-hour party comes to 250 drinks, 125 beers (0.76 of a keg), 15 bottles of wine and 75 lb of ice. Everything is computed locally and deterministically, so it is instant and private. Ideal for event-planning, catering, hospitality and party app developers, shopping-list and headcount tools, and host calculators. Pure local computation — no key, no third-party service, instant. US units; rules of thumb — round up. Live, nothing stored. 2 compute endpoints. Adjust for the crowd and the season.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/catering-api/..."
```

## Pricing
- **Free** (Free) — 6,850 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 60,500 calls/Mo, 6 req/s
- **Pro** ($11/Mo) — 247,500 calls/Mo, 15 req/s
- **Mega** ($35/Mo) — 1,385,000 calls/Mo, 40 req/s

## Endpoints

### Catering

#### `GET /v1/drinks` — Drink quantities

**Parameters:**
- `guests` (query, required, string) — Number of guests Example: `50`
- `hours` (query, required, string) — Event length (hours) Example: `4`
- `alcohol` (query, optional, string) — Serve alcohol (default true) Example: `true`
- `beer_percent` (query, optional, string) — Beer share % (default 50) Example: `50`
- `wine_percent` (query, optional, string) — Wine share % (default 30) Example: `30`
- `cocktail_percent` (query, optional, string) — Cocktail share % (default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/catering-api/v1/drinks?guests=50&hours=4&alcohol=true&beer_percent=50&wine_percent=30&cocktail_percent=20"
```

#### `GET /v1/food` — Food quantities

**Parameters:**
- `guests` (query, required, string) — Number of guests Example: `50`
- `appetite` (query, optional, string) — light, standard or hearty Example: `standard`
- `sides` (query, optional, string) — Number of side dishes (default 3) Example: `3`
- `appetizers_per_person` (query, optional, string) — Appetizer pieces each (default 6)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/catering-api/v1/food?guests=50&appetite=standard&sides=3"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/catering-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/catering-api
OpenAPI spec: https://www.oanor.com/api/catering-api/openapi.json