{"openapi":"3.1.0","info":{"title":"Beekeeping API","version":"1.0.0","description":"Beekeeping and apiary maths as an API, computed locally and deterministically — the mite, brood and winter-stores numbers a beekeeper manages a hive with. The varroa endpoint turns an alcohol-wash or sugar-shake count into the infestation rate: mites per 100 bees = mite count ÷ bees sampled × 100, where a half-cup scoop is about 300 bees, and it flags when the colony crosses the treatment threshold (commonly 3 mites per 100 bees, or 3 %). The brood endpoint projects the development calendar from the day an egg is laid: it hatches around day 3, the cell is capped around day 8–10 and the adult emerges on day 16 for a queen, 21 for a worker and 24 for a drone — so a worker egg laid on the 1st emerges three weeks later. The stores endpoint sizes winter honey: how many kilograms the colony needs by climate (about 12 kg mild to 35 kg harsh), the equivalent full deep frames (~2.25 kg each), and the deficit and frames to feed against the current stores. Date arithmetic is exact. Everything is computed locally and deterministically, so it is instant and private. Ideal for beekeeping, apiary-management, homestead and agriculture app developers, hive-inspection and mite-monitoring tools, and beekeeping education. Pure local computation — no key, no third-party service, instant. Dates as YYYY-MM-DD; metric weights. Live, nothing stored. 3 compute endpoints. A planning aid — local conditions vary.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/apiary-api","description":"oanor gateway"}],"tags":[{"name":"Apiary"},{"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/brood":{"get":{"operationId":"get_v1_brood","tags":["Apiary"],"summary":"Brood development dates","description":"","parameters":[{"name":"caste","in":"query","required":false,"description":"queen, worker or drone","schema":{"type":"string"},"example":"worker"},{"name":"lay_date","in":"query","required":true,"description":"Egg-lay date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-01"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/stores":{"get":{"operationId":"get_v1_stores","tags":["Apiary"],"summary":"Winter honey stores","description":"","parameters":[{"name":"climate","in":"query","required":false,"description":"mild, temperate, cold, harsh","schema":{"type":"string"},"example":"cold"},{"name":"honey_needed_kg","in":"query","required":false,"description":"Or target honey kg","schema":{"type":"string"}},{"name":"honey_per_frame_kg","in":"query","required":false,"description":"Honey per deep frame kg (default 2.25)","schema":{"type":"string"}},{"name":"current_stores_kg","in":"query","required":false,"description":"Current stores kg","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/varroa":{"get":{"operationId":"get_v1_varroa","tags":["Apiary"],"summary":"Varroa infestation %","description":"","parameters":[{"name":"mite_count","in":"query","required":true,"description":"Mites counted","schema":{"type":"string"},"example":"9"},{"name":"bees_sampled","in":"query","required":false,"description":"Bees in sample (default 300)","schema":{"type":"string"},"example":"300"},{"name":"threshold_percent","in":"query","required":false,"description":"Treatment threshold % (default 3)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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"},"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":290,"monthly_call_quota":67000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":810,"monthly_call_quota":262000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2600,"monthly_call_quota":1490000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/apiary-api"}