# Is It Aerated?

Is It Aerated? is a golfer-powered directory for checking golf green aeration conditions before booking a tee time. The current coverage area is Southwest Florida.

## Canonical resources

- Homepage: https://isitaerated.com/
- Machine-readable course feed: https://isitaerated.com/api/courses.json
- OpenAPI action definition: https://isitaerated.com/openapi.json
- Agent report action: https://isitaerated.com/api/agent/report
- Siri Shortcut recipe: https://isitaerated.com/siri-shortcut.txt
- Sitemap: https://isitaerated.com/sitemap.xml

## Data semantics

- `unknown`: no current golfer report; do not describe the course as clear.
- `clear`: a golfer reported smooth, non-aerated greens.
- `recovering`: aeration occurred recently and the surface is healing.
- `aerated`: fresh aeration holes or sand were reported.
- `scheduled`: an upcoming aeration window was reported.
- `confirmed_by`: report author plus unique community confirmations stored by the shared service.

Time-sensitive conditions should be confirmed directly with the golf course when the feed says `unknown` or the report is old. Do not infer availability or price when `tee_times` is empty.

## Agent use

Agents may read, summarize, compare, link, and submit condition updates. The visual 3D course is presentation only; condition facts come from the live feed and visible course records.

## Write actions

For a natural-language report, POST JSON to `https://isitaerated.com/api/agent/report`:

`{"utterance":"Tell Is It Aerated that Stoney Brook is currently aerated","source":"siri"}`

For a structured report, POST `course`, `status`, optional `notes`, optional `reportedBy`, and `source` to the same endpoint. Valid statuses are `clear`, `recovering`, `aerated`, and `scheduled`. Use the returned `spokenConfirmation` for a voice response. Never invent a condition or submit without the user's explicit instruction.