Party punch batch calculator
Scale a punch tested for 8 to a bowl for 24: 250, 500 and 750 of spirit, juice and mixer become 750, 1500 and 2250, with the amount per glass and each share shown. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Spirit
- 250
- Juice
- 500
- Mixer
- 750
- Servings
- 8
- Target servings
- 24
- Factor
- 3
- Spirit total
- 750
- Juice total
- 1,500
- Mixer total
- 2,250
A party punch is almost always the same three volumes—spirit, juice, and mixer—written for a small test batch and then scaled up for the bowl on the table. Hosts, caterers, and bar programs need those three amounts multiplied for a real guest count without breaking the balance of the original recipe. This party punch batch calculator takes the spirit, juice, and mixer volumes from your base recipe, an optional original serving count (default one), and a positive target serving count, then returns the scaled batch totals, the volume per serving, and the percentage share of each component so the bowl still tastes like the sample. Zero spirit is allowed for a non-alcoholic punch; negative volumes are rejected.
How spirit, juice, and mixer become a party batch
Punch recipes are usually recorded as three measured volumes in the same unit—millilitres, fluid ounces, or cups—for a known number of servings. Scaling is linear: if the base recipe yields eight servings and you need twenty-four, every component is multiplied by three. The method does not convert units for you: enter all three base volumes in one unit and read the scaled totals in that same unit.
It also does not estimate alcohol by volume or ice melt; those depend on proof, dilution, and how long the bowl sits. What it guarantees is a deterministic linear scale so a twenty-four-serving party list matches the taste of an eight-serving test batch when the same ratios are used.
Where a party punch batch calculator earns its keep
Home hosts who tested a small pitcher for eight and suddenly need a bowl for twenty-four guests can multiply spirit, juice, and mixer without redoing the taste math by hand. Catering bars and event planners scale the same house punch across weddings and corporate nights with deterministic prep sheets so two shifts buy the same case counts. Culinary and bartending classes teach ratio preservation by showing that tripling servings triples each component; a pure oracle lets students check homework in seconds.
Prefer this capability when your punch is defined as three volumes and a serving count; it is not a general multi-ingredient recipe scaler with an open list, not an ABV estimator, not a ice-dilution model, and not a cocktail single-serve free-pour guide.
What you can do with it
Scale a test pitcher to a party bowl
Enter spirit, juice, and mixer from an 8-serving test batch and a guest count of 24 to get shopping-list totals in the same unit.
Catering and bar prep sheets
Convert a house punch ratio into deterministic case quantities for weddings and multi-shift events without rewriting the recipe.
Apps, homework, and virgin punch
Power a guest-count field in a recipe app, check ratio homework, or scale a zero-spirit mocktail punch the same way as a spiked bowl.
FAQ
Can I make a non-alcoholic punch?
Yes. Set spirit to 0 and keep juice and mixer non-negative. Scaling still multiplies all three fields and returns totals and percentages.
Do I need to convert units myself?
Yes. Use one unit for spirit, juice, and mixer (mL, fl oz, cups, etc.). Scaled totals use that same unit; the calculator does not convert between units.
How much punch goes into each glass?
In the example scaled to 24 servings, each glass gets 187.5: 31.25 of spirit, 62.5 of juice and 93.75 of mixer, in the same unit you entered. That makes it easy to portion from the bowl.
Does it tell me how strong the punch is?
No. It does not estimate alcohol by volume or ice melt, because those depend on the spirit's proof, dilution and how long the bowl sits. It shows each component's share of the total instead.
What is a classic punch balance?
A common guide is roughly one part spirit, two parts juice and three parts mixer. The calculator keeps your own ratios exactly and shows each share, so you can check a large batch against that guide.
Related tools
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/cook/punch-scale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"spirit":250,"juice":500,"mixer":750,"target_servings":24}'const res = await fetch("https://api.kit.forhosting.com/cook/punch-scale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"spirit": 250,
"juice": 500,
"mixer": 750,
"target_servings": 24
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/cook/punch-scale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"spirit": 250,
"juice": 500,
"mixer": 750,
"target_servings": 24
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/cook/punch-scale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"spirit":250,"juice":500,"mixer":750,"target_servings":24}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"spirit":250,"juice":500,"mixer":750,"target_servings":24}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/cook/punch-scale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"spirit": 250,
"juice": 500,
"mixer": 750,
"target_servings": 24
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "cook.punch_scale",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
Non-positive servings or targets fail with invalid_input instead of inventing a zero or negative batch.
How spirit, juice, and mixer become a party batch
In symbols, servings is the positive base yield (default one when omitted), target_servings is the positive guest or glass count you want, and factor equals target_servings divided by servings. Then spirit_total equals spirit times factor, juice_total equals juice times factor, mixer_total equals mixer times factor, and total_volume is the sum of those three scaled volumes. Per-serving fields divide each total by target_servings so a bartender can portion single glasses from the bowl, and percentage fields report each component as a share of total_volume so you can check that a large batch still sits near a classic punch balance—often roughly one part spirit to two parts juice to three parts mixer, though your own ratios are preserved exactly.
Input contract, response shape, and error behaviour
Example: spirit two hundred fifty, juice five hundred, mixer seven hundred fifty for eight servings scaled to twenty-four yields factor three and totals seven hundred fifty, one thousand five hundred, and two thousand two hundred fifty with total volume four thousand five hundred in the same unit you entered. POST a JSON body with three required non-negative finite numbers—spirit (aliases liquor, alcohol, booze, spirit_ml, spirit_volume), juice (aliases fruit_juice, citrus, juice_ml, juice_volume), and mixer (aliases soda, sparkling, soft_drink, mixer_ml, mixer_volume)—plus a required positive target_servings (aliases target, to_servings, guests, party_servings, for). Optional servings (aliases base_servings, original_servings, from_servings, recipe_servings, n) defaults to one and must be positive when provided. Missing required fields, empty strings, non-finite values, negative volumes, zero servings, zero target_servings, and negative serving counts fail with invalid_input naming the problem and are not billed. On success the body echoes spirit, juice, mixer, servings, and target_servings; returns factor; returns spirit_total, juice_total, mixer_total, and total_volume; returns spirit_per_serving, juice_per_serving, mixer_per_serving, and volume_per_serving; returns spirit_pct, juice_pct, and mixer_pct (percentages of total volume, or zero when total is zero); and includes formula, method, and a one-line English message for UI copy. Failed validation does not consume prepaid balance.
Where a party punch batch calculator earns its keep
Recipe sites and party-planning apps can call a tiny parse endpoint when a user types a guest count and expect shopping-list volumes back in the unit they already use. Always serve alcohol responsibly, label non-alcoholic options clearly, and chill the bowl—those kitchen rules sit outside the numeric scope of this endpoint but matter on the floor.
Technical questions
How do I scale a party punch recipe by servings?
Send non-negative spirit, juice, and mixer volumes for the base recipe, optional positive servings (default 1), and positive target_servings. The API returns factor = target_servings ÷ servings and multiplies each volume by that factor.
What happens if servings or target_servings is zero or negative?
The task fails with invalid_input. Both serving counts must be finite numbers greater than zero; non-positive values are not billed.
What does the party punch batch calculator cost?
The browser tool is free. API requests use prepaid KIT balance at $0.002 per successful call; invalid input is not billed.