{"openapi":"3.1.0","info":{"title":"Home Canning API","version":"1.0.0","description":"Home-canning maths as an API, computed locally and deterministically — the altitude adjustments that keep a batch of preserves safe, the numbers a canner, homesteader or recipe app processes a jar by. Because water boils cooler the higher you are, every tested sea-level recipe has to run longer or hotter, and this API does that arithmetic. The waterbath endpoint applies the USDA boiling-water-bath and steam-canner rule: for a base process of 20 minutes or less add 5, 10, 15 or 20 minutes by altitude band, and for more than 20 minutes add 10, 20, 30 or 40 — so a 15-minute pickle recipe at 4,000 feet processes 25 minutes, and a 30-minute one runs 50. The pressure endpoint adjusts the canner: a dial gauge gains 1 psi per 2,000 feet, turning an 11 psi recipe into 12, 13, 14 or 15, while a weighted gauge simply steps from 10 psi up to 1,000 feet to 15 above it, since it only has 5/10/15 settings. The boilingpoint endpoint gives the underlying reason — water boils about 1.84 °F lower per 1,000 feet, so 5,000 feet boils at 202.8 °F instead of 212. Everything is computed locally and deterministically, so it is instant and private. Ideal for canning, food-preservation, homesteading, recipe and kitchen app developers, preserving-calculator and pantry tools, and cooking-class software. Pure local computation — no key, no third-party service, instant. USDA tables — always follow a tested recipe. Live, nothing stored. 3 compute endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/canning-api","description":"oanor gateway"}],"tags":[{"name":"Canning"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/boilingpoint":{"get":{"operationId":"get_v1_boilingpoint","tags":["Canning"],"summary":"Boiling point at altitude","description":"","parameters":[{"name":"altitude","in":"query","required":true,"description":"Altitude","schema":{"type":"string"},"example":"5000"},{"name":"unit","in":"query","required":false,"description":"ft or m","schema":{"type":"string"},"example":"ft"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Water boils about 1.84 °F (1 °C per ~290 m) lower per 1,000 ft of altitude, so boiling-water canning is cooler and must run longer — and pressure canning is required for low-acid foods to reach a safe temperature.","inputs":{"unit":"ft","altitude_ft":5000},"boiling_point_c":94.9,"boiling_point_f":202.8},"meta":{"timestamp":"2026-06-06T07:14:02.960Z","request_id":"c79d6776-5df6-4769-a519-6e92c32a27c8"},"status":"ok","message":"Boiling point","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/pressure":{"get":{"operationId":"get_v1_pressure","tags":["Canning"],"summary":"Altitude canner pressure","description":"","parameters":[{"name":"altitude","in":"query","required":true,"description":"Altitude","schema":{"type":"string"},"example":"5000"},{"name":"gauge","in":"query","required":false,"description":"dial or weighted (default dial)","schema":{"type":"string"},"example":"dial"},{"name":"sea_level_psi","in":"query","required":false,"description":"Recipe sea-level psi (dial default 11)","schema":{"type":"string"},"example":"11"},{"name":"unit","in":"query","required":false,"description":"ft or m","schema":{"type":"string"},"example":"ft"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Pressure-canner adjustment. Dial gauge: add 1 psi per 2,000 ft above 2,000 (so an 11 psi recipe becomes 12/13/14/15). Weighted gauge: 10 psi up to 1,000 ft, otherwise 15 psi (it only has 5/10/15 settings). Always process at or above the recommended pressure.","inputs":{"unit":"ft","gauge":"dial","altitude_ft":5000},"altitude_band":"4,001–6,000 ft","recommended_psi":13},"meta":{"timestamp":"2026-06-06T07:14:03.066Z","request_id":"f92a0af4-ba79-4811-8408-e86f53878d03"},"status":"ok","message":"Canner pressure","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/waterbath":{"get":{"operationId":"get_v1_waterbath","tags":["Canning"],"summary":"Altitude water-bath time","description":"","parameters":[{"name":"base_minutes","in":"query","required":true,"description":"Sea-level process time (min)","schema":{"type":"string"},"example":"15"},{"name":"altitude","in":"query","required":true,"description":"Altitude","schema":{"type":"string"},"example":"4000"},{"name":"unit","in":"query","required":false,"description":"ft or m (default ft)","schema":{"type":"string"},"example":"ft"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"USDA boiling-water-bath / steam adjustment. For a base process of 20 minutes or less add 5/10/15/20 min by altitude band; for more than 20 minutes add 10/20/30/40. Water boils cooler with altitude, so it must process longer.","inputs":{"unit":"ft","altitude_ft":4000,"base_minutes":15},"added_minutes":10,"altitude_band":"3,001–6,000 ft","total_minutes":25},"meta":{"timestamp":"2026-06-06T07:14:03.176Z","request_id":"ab004300-df17-4d17-9684-b7f39c1aa819"},"status":"ok","message":"Water-bath time","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Altitude in feet or metres. Water-bath adds 5–20 min (≤20 min base) or 10–40 (>20 min) by band; dial pressure +1 psi per 2,000 ft; weighted 10/15 psi. Food-safety guidance from USDA tables — always follow a tested recipe.","service":"canning-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/pressure":"Altitude-adjusted pressure for a dial or weighted gauge canner.","GET /v1/waterbath":"Altitude-adjusted boiling-water-bath / steam processing time.","GET /v1/boilingpoint":"Boiling point of water at a given altitude."},"description":"Home-canning maths: USDA altitude adjustments for boiling-water-bath processing time and pressure-canner pressure, plus water's boiling point at altitude."},"meta":{"timestamp":"2026-06-06T07:14:03.274Z","request_id":"d579844c-3fee-40a8-a2c6-35c02ca0bbb2"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7150,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":408,"monthly_call_quota":58500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1135,"monthly_call_quota":237000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3640,"monthly_call_quota":1358000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/canning-api"}