{"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"},"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"},"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"},"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":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"}