{"openapi":"3.1.0","info":{"title":"Egg Incubation API","version":"1.0.0","description":"Egg-incubation maths as an API, computed locally and deterministically — the hatch timeline, conditions and brooder numbers a hatchery or backyard chicken-keeper raises a clutch by. The hatch endpoint turns the set day (day 0) into the schedule by species: it knows the incubation period — chicken 21 days, duck 28, quail 17, goose 30, turkey 28, Muscovy 35 and more — and gives the lockdown day, about three days before hatch, when you stop turning the eggs, raise the humidity and leave the lid shut; pass a custom incubation_days for anything else. The conditions endpoint gives the targets: a forced-air incubator at 99.5 °F (still-air a degree or two higher at the top of the eggs), with humidity around 45–55 % through incubation and 65–75 % at lockdown so the membrane stays soft. The brooder endpoint schedules the chicks after they hatch — 95 °F under the lamp in week one, dropping 5 °F a week until they reach room temperature around 70 °F and are feathered enough to leave it. Everything is computed locally and deterministically, so it is instant and private. Ideal for poultry, hatchery, homesteading and farm app developers, incubation-timer and brooder tools, and 4-H / education software. Pure local computation — no key, no third-party service, instant. Guidance — candle the eggs and watch the chicks. Live, nothing stored. 3 compute endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/incubation-api","description":"oanor gateway"}],"tags":[{"name":"Incubation"},{"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/brooder":{"get":{"operationId":"get_v1_brooder","tags":["Incubation"],"summary":"Brooder temperature","description":"","parameters":[{"name":"week","in":"query","required":true,"description":"Chick age in weeks","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Start chicks at 95 °F (35 °C) under the lamp in week 1 and lower 5 °F each week until you reach about 70 °F, then they're feathered enough for ambient. Watch the birds, not just the thermometer: huddled = too cold, spread to the edges = too hot.","inputs":{"week":1},"temperature_c":35,"temperature_f":95,"at_room_temperature":false},"meta":{"timestamp":"2026-06-06T15:30:52.026Z","request_id":"b78fecc8-e82b-4060-87d0-60f0cc0961a1"},"status":"ok","message":"Brooder temp","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/conditions":{"get":{"operationId":"get_v1_conditions","tags":["Incubation"],"summary":"Temp & humidity","description":"","parameters":[{"name":"stage","in":"query","required":false,"description":"incubation or lockdown (default incubation)","schema":{"type":"string"},"example":"incubation"},{"name":"still_air","in":"query","required":false,"description":"true for a still-air incubator","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Forced-air incubators run 99.5 °F (37.5 °C); still-air 1–2 °F higher measured at the top of the eggs. Humidity ~45–55 % during incubation, raised to 65–75 % at lockdown so the membrane stays soft for the hatch. Ventilate more as hatch nears.","inputs":{"stage":"incubation","still_air":false},"humidity":"45–55 %","temperature_c":37.5,"temperature_f":99.5},"meta":{"timestamp":"2026-06-06T15:30:52.096Z","request_id":"b37b4b2d-925e-44fc-9338-8468a2900b21"},"status":"ok","message":"Incubation conditions","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/hatch":{"get":{"operationId":"get_v1_hatch","tags":["Incubation"],"summary":"Hatch timeline","description":"","parameters":[{"name":"species","in":"query","required":false,"description":"chicken, duck, quail, goose, turkey, muscovy, …","schema":{"type":"string"},"example":"chicken"},{"name":"incubation_days","in":"query","required":false,"description":"Custom incubation period (days)","schema":{"type":"string"}},{"name":"lockdown_days_before","in":"query","required":false,"description":"Days before hatch to lock down (default 3)","schema":{"type":"string"},"example":"3"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Day 0 is when you set the eggs. Turn them until lockdown — about 3 days before hatch — then stop turning, raise the humidity and don't open the incubator. Chicken 21 days, duck 28, quail 17, goose 30; bigger or waterfowl eggs take longer.","inputs":{"species":"chicken","incubation_days":21,"lockdown_days_before":3},"set_day":0,"lockdown_day":18,"incubation_days":21,"stop_turning_day":18,"expected_hatch_day":21},"meta":{"timestamp":"2026-06-06T15:30:52.177Z","request_id":"fd557a3f-a38f-43c2-a443-d70a8abe2bc6"},"status":"ok","message":"Hatch timeline","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":"Day 0 = set day; lockdown ~3 days before hatch. Chicken 21, duck 28, quail 17, goose 30, turkey 28 days. Forced-air 99.5 °F; brooder 95 °F week 1, −5 °F/week. Guidance — watch the birds and candle the eggs.","service":"incubation-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/hatch":"Lockdown day and hatch day from the set day, by species or incubation days.","GET /v1/brooder":"Brooder temperature for a chick's age in weeks.","GET /v1/conditions":"Temperature and humidity for the incubation and lockdown stages."},"description":"Egg-incubation maths: hatch timeline by species, temperature & humidity targets, and the chick brooder temperature schedule."},"meta":{"timestamp":"2026-06-06T15:30:52.252Z","request_id":"f6774f76-3960-4400-8c7c-e23fdb160147"},"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":6560,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":429,"monthly_call_quota":55700,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1188,"monthly_call_quota":228700,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3788,"monthly_call_quota":1329000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/incubation-api"}