# Business Hours

## List business hours schedules

 - [GET /v1/business-hours/schedules](https://docs.dixa.io/openapi/dixa-api/v1/business-hours/getbusiness-hoursschedules.md): List business hours schedules in an organization with pagination.

## Get a business hours schedule definition.

 - [GET /v1/business-hours/schedules/{scheduleId}/definition](https://docs.dixa.io/openapi/dixa-api/v1/business-hours/getbusiness-hoursschedulesscheduleiddefinition.md): Get a business hours schedule definition in an organization by providing its ID.

## Get the upcoming business hours schedule.

 - [GET /v1/business-hours/schedules/{scheduleId}/upcoming](https://docs.dixa.io/openapi/dixa-api/v1/business-hours/getbusiness-hoursschedulesscheduleidupcoming.md): 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.

## Check if a business is open

 - [GET /v1/business-hours/schedules/{scheduleId}/status](https://docs.dixa.io/openapi/dixa-api/v1/business-hours/getbusiness-hoursschedulesscheduleidstatus.md): Check if a business is open either right now or at the specified timestamp. When the business is open, closesAt holds the end of the current open interval and opensAt is null. When it is closed, opensAt holds the start of the next open interval — if there is one within the next year — and closesAt is null.