# Get the upcoming business hours schedule.

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.

Endpoint: GET /v1/business-hours/schedules/{scheduleId}/upcoming
Version: v1
Security: ApiKeyAuth

## Path parameters:

  - `scheduleId` (string, required)

## Query parameters:

  - `days` (integer)
    Number of upcoming days to include in the response. Must be between 1 and 90.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.schedule` (object, required)

  - `data.schedule.id` (string, required)

  - `data.schedule.name` (string, required)

  - `data.schedule.timezone` (string, required)

  - `data.schedule.businessHours` (array)

  - `data.schedule.businessHours.name` (string, required)

  - `data.schedule.businessHours.dayOfWeek` (integer)

  - `data.schedule.businessHours.businessHourType` (any, required)

  - `data.schedule.businessHours.status` (any, required)

  - `data.schedule.businessHours.intervals` (array)

  - `data.schedule.businessHours.intervals.startTime` (string, required)

  - `data.schedule.businessHours.intervals.endTime` (string, required)

  - `data.schedule.businessHours.recurring` (object)

  - `data.schedule.businessHours.recurring.dayOfMonth` (integer)

  - `data.schedule.businessHours.recurring.monthOfYear` (integer)

  - `data.schedule.businessHours.recurring.holiday` (string)

  - `data.schedule.businessHours.startDate` (string, required)

  - `data.schedule.businessHours.nextDate` (string)

## Response 400 fields (application/json):

  - `message` (string, required)

## Response 404 fields (application/json):

  - `message` (string, required)

## Response 500 fields (application/json):

  - `message` (string, required)