Opening Hours Model

Opening hours of some MPC entities are represented by arrays of items (OpeningHoursItem) where each defines entity's working hours for given day.

Model

OpeningHoursItem

type

enum<string>

required

Allowed value:

weekday

Example:

weekday

period

required

Any of

date

string

For type: "day"

Example:

2023-01-15

hours

object | null

required

When null, object is closed at this period

opens_at

string

required

Hour of entity opening time

Example:

09:00

closes_at

string

required

Hour of entity closing time

Example:

15:00

description

object (LocalizedContent) | null

optional

Additional description useful for "day" type

Example:

{"en":"Text"}

Additional properties

string | null

optional

The actual set of languages depends on LC configuration. See: Localization

Example:

Tekst

Items with weekday type specify regular working hours for each day of the week (API always returns at least one item for each week day).

Valid period values for this type are: monday, tuesday, wednesday, thursday, friday, saturday, sunday.

Items with type day specify special working hours for specific day (period has YYYY-MM-DD format) that override regular ones.

Any day may have opening time defined in multiple periods (hours do not overlap).
For instance, in attached example, on tuesday the entity is open in two periods:
10:00-15:00 and 16:00-18:00 with a one hour break between them.

Items returned from API are sorted in following order:

type ASC (weekday < day)

period ASC (chronological order)

hours.opens_at ASC (chronological order)

Example

Array of OpeningHoursItem for some object:


[
  { "type": "weekday", "period": "monday", "hours": { "opens_at": "10:00", "closes_at": "18:00" } },
  { "type": "weekday", "period": "tuesday", "hours": { "opens_at": "10:00", "closes_at": "15:00" } },
  { "type": "weekday", "period": "tuesday", "hours": { "opens_at": "16:00", "closes_at": "18:00" } },
  { "type": "weekday", "period": "wednesday", "hours": { "opens_at": "10:00", "closes_at": "18:00" } },
  { "type": "weekday", "period": "thursday", "hours": { "opens_at": "10:00", "closes_at": "18:00" } },
  { "type": "weekday", "period": "friday", "hours": {"opens_at": "10:00", "closes_at": "18:00" } },
  { "type": "weekday", "period": "saturday", "hours": { "opens_at": "12:00", "closes_at": "15:00" } },
  { "type": "weekday", "period": "sunday", "hours": null },
  { "type": "day", "period": "2023-05-01", "hours": null },
  { "type": "day", "period": "2023-12-22", "hours": { "opens_at": "12:00", "closes_at": "14:00" } },
  { "type": "day", "period": "2023-12-25", "hours": null, "description": { "en": "Christmas", "no": "Jul"} }
]

Model#

Example#

Model

Example