---
title: "Get Dates Available for Booking"
method: GET
path: "/book_dates/{location_id}"
tags: ["Online Booking"]
---

# Get Dates Available for Booking

`GET /book_dates/{location_id}`

The dates available for booking object has the following fields:

| Field | Type | Description |
| ------------- | ------------- | ------------- |
| working_days | array of working days grouped by month | Working days of a team member/organization |
| working_dates | array of dates | An array of dates when the team member/organization works |
| booking_days | array of days when there are free sessions | Array of days that are available for booking for the specified services |
| booking_dates | array of dates | An array of dates when there are free sessions for the service to the selected team member/organization |

working days and booking_days have the same format:
month:[array of days in this month]

For example, this booking_days:
        "9": [
              "4",
              "5"]
        "10": [
              "14",
              "25"]
Means that on September 4 and 5, and on October 14 and 25 there are free sessions for booking


The following filters are available:

+ service_ids: Array of service IDs. If you need dates when you can book the specified services
+ staff_id: team member ID. If you need dates when you can book the specified team member
+ date: Date within a month, if you need dates for a specific month

## Path parameters

- `location_id` number, required

## Query parameters

- `service_ids[]` string
- `staff_id` number
- `date` string
- `date_from` string
- `date_to` string

## Headers

- `Accept` string, required
- `Content-Type` string, required
- `Authorization` string, required

## Response `200`

OK

- BookDatesCompanyidDataTypes — Get a list of dates available for appointment
  - `success` boolean — Execution success status (true)
  - `data` object — Data (object)
    - `booking_days` object — Object with month numbers as keys and arrays of available days as values (empty array when no data)
    - `booking_dates` string[] — An array of dates when there are free sessions for the service to the selected team member/organization
    - `working_days` object — Object with month numbers as keys and arrays of working days as values (empty array when no data)
    - `working_dates` string[] — An array of dates when the team member/organization works
  - `meta` object[] — Metadata (empty array)

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/alteg/apis/online-booking.md) · [All operations](https://skmtc.net/alteg/apis/online-booking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alteg/online-booking/versions/623dc683246f/schema)