# Egg Incubation API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/incubation-api/..."
```

## Pricing
- **Free** (Free) — 6,560 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 55,700 calls/Mo, 6 req/s
- **Pro** ($12/Mo) — 228,700 calls/Mo, 15 req/s
- **Mega** ($38/Mo) — 1,329,000 calls/Mo, 40 req/s

## Endpoints

### Incubation

#### `GET /v1/brooder` — Brooder temperature

**Parameters:**
- `week` (query, required, string) — Chick age in weeks Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/incubation-api/v1/brooder?week=1"
```

#### `GET /v1/conditions` — Temp & humidity

**Parameters:**
- `stage` (query, optional, string) — incubation or lockdown (default incubation) Example: `incubation`
- `still_air` (query, optional, string) — true for a still-air incubator Example: `false`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/incubation-api/v1/conditions?stage=incubation&still_air=false"
```

#### `GET /v1/hatch` — Hatch timeline

**Parameters:**
- `species` (query, optional, string) — chicken, duck, quail, goose, turkey, muscovy, … Example: `chicken`
- `incubation_days` (query, optional, string) — Custom incubation period (days)
- `lockdown_days_before` (query, optional, string) — Days before hatch to lock down (default 3) Example: `3`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/incubation-api/v1/hatch?species=chicken&lockdown_days_before=3"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/incubation-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/incubation-api
OpenAPI spec: https://www.oanor.com/api/incubation-api/openapi.json