# SpotEvent

A recurring or one-off event worth timing a visit for: a light show, a festival, a tide. The apps show the next listed date. At most 12 per spot.

Group: Planning facts.

## Fields

- `name` (string, required): The event's name, at most 80 characters.
- `when` (string, required): When, in words, at most 200 characters (every night at 19:45 and 20:45).
- `dates` (array of strings, optional): Exact dates when known (YYYY-MM-DD, up to 60). Readiness lists events whose dates have all passed.
- `months` (array of numbers, optional): The months it happens (1 to 12).
- `url` (string, optional): The event's page (http or https).
- `free` (boolean, optional): true when it costs nothing to watch.
- `note` (string, optional): One line of context, at most 300 characters.

## Used by

- [create_spot](https://developers.sceniq.earth/reference/create_spot.md)
- [update_spot](https://developers.sceniq.earth/reference/update_spot.md)
- [upsert_spots](https://developers.sceniq.earth/reference/upsert_spots.md)