---
title: "Get Available Days"
method: GET
path: "/consumer/v1/availability/{serviceId}/{startDate}/{endDate}/days"
tags: ["Availability"]
---

# Get Available Days

`GET /consumer/v1/availability/{serviceId}/{startDate}/{endDate}/days`

This endpoint will return **Day Level Availability** for the range of dates requested. For example, if the business is closed, or there is a public holiday this endpoint will return that the "Day is unavailable".

Day Availability is a high-level check for Holidays and Open/Available hours of a location, service and/or resource and should be used to restrict your choices of days available in your application to improve usability and performance.

A **serviceId** is required. The **startDate** and **endDate** are required and are formatted as: **YYYY-MM-DD**

The locationId is optional, however if not supplied it defaults to the Primary Business Location for open/closed hours information. It is recommended you always provide the locationId.

A **resourceId** is optional. If used the available days will be return day availability for the resource specified.

The **tzOffset** parameter should be used if the appointment requester, the end user, is in a different timezone than the location or resource.

## Path parameters

- `serviceId` string, required
- `startDate` string, date-time, required
- `endDate` string, date-time, required

## Query parameters

- `locationId` string
- `resourceId` string
- `tzOffset` integer

## Response `200`

Success

- AvailabilityDayViewModel
  - `url` string, nullable
  - `object` string, nullable
  - `serviceId` string, nullable
  - `serviceName` string, nullable
  - `serviceDescription` string, nullable
  - `resourceId` string, nullable
  - `resourceName` string, nullable
  - `resourceDescription` string, nullable
  - `tzRequested` integer, nullable
  - `availableDays` AvailableDayViewModel[], nullable
    - `object` string, nullable
    - `date` string, nullable
    - `closed` boolean
    - `available` boolean
    - `reasonCode` integer
    - `reason` string, nullable
    - `bookingLimit` integer
    - `bookingCount` integer

---

[API](https://skmtc.net/onsched/apis/onsched-consumer-api.md) · [All operations](https://skmtc.net/onsched/apis/onsched-consumer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onsched/onsched-consumer-api/versions/1cd2a28a0305/schema)