---
title: "List open times"
description: "The start times a guest could book on a page in a window."
url: "https://openemail.uk/docs/api/bookings/times"
area: "API"
category: "Mailbox"
---

# List open times

The start times a guest could book on a page in a window.

`GET /booking-pages/{id}/times`

## GET /booking-pages/{id}/times

The start times a guest could book on a page in a window.

## Example

Needs `calendar:read`. `from` and `to` are ISO 8601 instants. Left out, the window starts now and runs 14 days, and it never runs longer than 62 days. `durationMinutes` picks one of the lengths of the page and defaults to the shortest.

**curl**

```
curl "$OE/booking-pages/bkp_5c1e9a7b3d2f48e6a0b4c7d1/times?from=2026-11-03T00:00:00Z&to=2026-11-04T00:00:00Z" -H "$AUTH"
```

**Response**

```
{
  "object": "booking_times",
  "pageId": "bkp_5c1e9a7b3d2f48e6a0b4c7d1",
  "timezone": "Europe/Berlin",
  "durationMinutes": 30,
  "times": ["2026-11-03T08:00:00.000Z", "2026-11-03T08:30:00.000Z", "2026-11-03T10:00:00.000Z"]
}
```

> The times already have the calendar, other bookings, the gaps around meetings, the daily limit, the notice and out of office taken out.

> A paused page still answers, so you can check its hours before opening it. A page with a `problem` answers an empty list.

> A length the page does not offer, or a `to` that is not later than `from`, answers 422 `invalid_parameter`.

> With `bookingId` the times are the ones that booking can move to with `POST /bookings/{id}/reschedule`: its own time counts as free, and they are for its length.

## Reference

- [`GET /booking-pages/{id}/times`](https://openemail.uk/docs/api/reference/booking-pages#get-booking-pages-id-times): full reference