inventory APIv1.6.0


This type is used to express the special operating hours of a store location on a specific date. A specialHours container is needed when the store's opening hours on a specific date are different than the normal operating hours on that particular day of the week.

Types that use SpecialHours

Calls that use SpecialHours


A date value is required for each specific date that the store location has special operating hours. The date is actually expressed as a time stamp specified in ISO 8601 format, which uses the 24-hour Coordinated Universal Time (UTC) clock. The following examples show (1) the format of the time-stamp, and (2) an example time value in ISO 8601 format:

Format: yyyy-MM-ddThh:mm:ssZ
Example: 2016-10-19T00:09:00Z

This field is returned if set for the store location.
array of Interval
This container is used to define the opening and closing times of a store on a specific date (defined in the date field). An intervals container is needed for each specific date that the store has special operating hours. These special operating hours on the specific date override the normal operating hours for the specific day of the week. If a store location closes for lunch (or any other period during the day) and then reopens, multiple open and close pairs are needed.

This container is returned if set for the store location.