---
title: "Check if a business is open"
method: GET
path: "/beta/business-hours/schedules/{scheduleId}/status"
tags: ["Business Hours"]
---

# Check if a business is open

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

## Request

- Base URL: `https://dev.dixa.io`
- URL: `https://dev.dixa.io/beta/business-hours/schedules/{scheduleId}/status`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/dixa/apis/dixa-api/docs/beta/business-hours/schedules/:scheduleId/status/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `scheduleId` string, required

## Query parameters

- `timestamp` string, date-time

## Response `200`

The business hours status

- GetBusinessOpenStatusOutput
  - `data` GetBusinessOpenStatusResult, required
    - `isOpen` boolean, required: Whether the business is open at the evaluated timestamp
    - `timestamp` string, date-time, required: The timestamp the status was evaluated at
    - `opensAt` string, date-time: When the business next opens. Only present while the business is closed and there is an upcoming open interval within the next year; null while the business is open
    - `closesAt` string, date-time: When the current open interval ends. Only present while the business is open; null while it is closed

## Other responses

- `400`: Invalid value for: query parameter timestamp, Invalid value extracted from request context
- `500`: Internal failure during request processing

---

[API](https://skmtc.dev/dixa/apis/dixa-api.md) - [All operations](https://skmtc.dev/dixa/apis/dixa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dixa/apis/dixa-api/revisions/4c9e4ef864d1?raw)