---
title: "Get the upcoming business hours schedule."
method: GET
path: "/beta/business-hours/schedules/{scheduleId}/upcoming"
tags: ["Business Hours"]
---

# Get the upcoming business hours schedule.

`GET /beta/business-hours/schedules/{scheduleId}/upcoming`

Get the resolved business hours schedule for the next number of days, applying recurring rules and exceptions.

## Path parameters

- `scheduleId` string, uuid, required

## Query parameters

- `days` integer

## Response `200`

- GetUpcomingBusinessHoursScheduleOutput
  - `data` GetUpcomingBusinessHoursScheduleResult, required
    - `schedule` BusinessHoursUpcomingSchedule, required
      - `id` string, required
      - `name` string, required
      - `timezone` string, required
      - `businessHours` BusinessHour[]
        - `name` string, required
        - `dayOfWeek` integer
        - `businessHourType` union, required
          - Exception1
          - Holiday1
          - Regular2
        - `status` union, required
          - Closed1
          - Open1
        - `intervals` TimeInterval1[]
          - `startTime` string, required
          - `endTime` string, required
        - `recurring` Recurring1
          - `dayOfMonth` integer
          - `monthOfYear` integer
          - `holiday` string
        - `startDate` string, required
        - `nextDate` string

## Other responses

- `400` — Invalid value for: path parameter scheduleId, Invalid value for: query parameter days, Invalid value extracted from request context
- `404` — An entity in this request could not be found
- `500` — Internal failure during request processing

---

[API](https://skmtc.net/dixa/apis/dixa-api.md) · [All operations](https://skmtc.net/dixa/apis/dixa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dixa/dixa-api/revisions/5eaff14a2c46/schema)