# Schedule

Structured opening hours. The free-text hours stay the fallback; the apps show today's hours in the spot's time zone. Readiness flags a schedule past validUntil.

Group: Planning facts.

## Fields

- `hours` (array of HoursBand, optional): Up to 24 bands; the last matching band wins.
  Fields of HoursBand: https://developers.sceniq.earth/fields/hours-band.md
- `specialDays` (array of objects, optional): Up to 40 days that differ from the bands: a date or a rule, closed or with their own times.
  - `date` (string, optional): The day (YYYY-MM-DD). Give a date or a rule.
  - `rule` (string, optional): A recurring day in words, at most 120 characters (first Sunday of the month).
  - `closed` (boolean, optional): true when the place is closed that day.
  - `open` (string, optional): Opening time that day as HH:MM, or sunrise or sunset.
  - `close` (string, optional): Closing time that day as HH:MM, or sunrise or sunset.
  - `note` (string, optional): One line for the day, at most 200 characters.
- `slots` (object, optional): Timed entry: entries every everyMin minutes from first to last.
  - `first` (string, required): The first entry time as HH:MM.
  - `last` (string, required): The last entry time as HH:MM.
  - `everyMin` (number, required): Minutes between entries.
  - `cap` (number, optional): People per slot, when the source states it (1 to 100,000).
  - `note` (string, optional): One line about booking a slot, at most 200 characters.
- `validFrom` (string, optional): The first day these hours apply (YYYY-MM-DD).
- `validUntil` (string, optional): The last day these hours apply (YYYY-MM-DD).
- `sourceUrl` (string, optional): The page the hours come from (http or https).
- `checkedOn` (string, optional): The day the value was last checked against its source (YYYY-MM-DD).
- `note` (string, optional): A note for the whole schedule, at most 500 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)
- [create_facility](https://developers.sceniq.earth/reference/create_facility.md)
- [update_facility](https://developers.sceniq.earth/reference/update_facility.md)