SpecialHours is a JSON Structure definition published by Otter, describing 3 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/otter/refs/heads/main/json-structure/public-api-special-hours-structure.json",
"name": "SpecialHours",
"description": "Describes the configuration of special store hours.",
"type": "object",
"properties": {
"date": {
"type": "date",
"description": "Date the special hour configuration applies.",
"example": "2021-10-01"
},
"timeRanges": {
"type": "array",
"minItems": 0,
"description": "Hours range applied to configured date. For open days, the timeRanges field is required. For closed days, the timeRanges field is ignored.",
"items": {
"$ref": "https://raw.githubusercontent.com/api-evangelist/otter/refs/heads/main/json-schema/public-api-time-range-schema.json"
}
},
"type": {
"type": "string",
"description": "Store state that should be applied during the configured special hour. If this field is set to CLOSED, the timeRanges field is ignored.",
"enum": [
"OPEN",
"CLOSED"
],
"example": "OPEN"
}
},
"required": [
"date",
"timeRanges",
"type"
]
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.