Get the upcoming business hours schedule.

GET
/v1/business-hours/schedules/{scheduleId}/upcoming

Get the resolved business hours schedule for the next number of days, applying recurring rules and exceptions. Each entry in businessHours describes one upcoming day (see its nextDate). An entry with status: Open lists the intervals during which the business is open on that day; between and outside those intervals it is closed. An entry with status: Closed is a day explicitly configured as closed and has no intervals. Days without any configured business hours are omitted from the response entirely, so businessHours can be empty when no day in the requested window has configured hours. In short: the business is open only during the intervals of status: Open entries, and closed at all other times.

Authorization

ApiKeyAuth
headerAuthorization<token>

Path Parameters

scheduleId*string
Formatuuid

Query Parameters

days?integer

Number of upcoming days to include in the response. Must be between 1 and 90.

Formatint32
Range1 <= value <= 90
Default7

Response Body

application/json
  1. response
data*
Example Request
curl -X GET 'https://dev.dixa.io/v1/business-hours/schedules/{scheduleId}/upcoming' \  -H 'Authorization: <API token>'
{
"data": {
"schedule": {
"id": "a0d559bf-cdf8-4088-841d-f3807b93272e",
"name": "Schedule 1",
"timezone": "Europe/Copenhagen",
"businessHours": [
{
"name": "Monday",
"dayOfWeek": 1,
"businessHourType": "Regular",
"status": "Open",
"intervals": [
{
"startTime": "08:00",
"endTime": "16:00"
}
],
"startDate": "2026-01-05",
"nextDate": "2026-05-25"
},
{
"name": "Tuesday",
"dayOfWeek": 2,
"businessHourType": "Regular",
"status": "Open",
"intervals": [
{
"startTime": "08:00",
"endTime": "16:00"
}
],
"startDate": "2026-01-06",
"nextDate": "2026-05-26"
}
]
}
}
}