---
title: "Bookings calendar"
method: GET
path: "/bookings/calendar"
tags: ["Admin Sales: Bookings"]
---

# Bookings calendar

`GET /bookings/calendar`

## Request

- Base URL: `http://localhost:8000/api/admin`
- URL: `http://localhost:8000/api/admin/bookings/calendar`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-admin-api/docs/bookings/calendar/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns every booking whose slot overlaps the window, unpaginated, the way the admin bookings calendar view loads them. The window defaults to the current week. Slot times are formatted in the store timezone and each booking carries the attributes stored on its order item.

## Query parameters

- `start` string, date
- `end` string, date

## Response `200`

The bookings in the window.

## Other responses

- `401`: Missing or invalid admin token.
- `403`: Admin role lacks sales.bookings.
- `422`: start or end is not a Y-m-d date.

## Changes

- **2026-10-28** `3198f11be70f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-admin-api/changes/bookings/calendar/get.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-admin-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-admin-api/revisions/3198f11be70f?raw)