---
title: "Booking events"
method: GET
path: "/v1/events"
tags: ["Bookings"]
---

# Booking events

`GET /v1/events`

## Request

- Base URL: `https://threshold.rentals/api`
- URL: `https://threshold.rentals/api/v1/events`
- Auth: HTTP bearer

The 50 latest events on bookings your agent made, newest first (e.g. booking.confirmed, booking.declined, booking.cancelled, booking.arrival_info_ready). An alternative to polling each booking.

## Response `200`

Events

- object
  - `events` Event[]
    - `id` string
    - `type` string
    - `created_at` string, date-time
    - `data` object

## Other responses

- `401`: Agent token missing (unauthorized)
- `429`: Rate limited or too many open requests: see Retry-After

---

[API](https://skmtc.dev/threshold/apis/threshold-stays-api.md) · [All operations](https://skmtc.dev/threshold/apis/threshold-stays-api/llms.txt) · [OpenAPI document](https://skmtc.dev/threshold/apis/threshold-stays-api/revisions/7acf3ae91b56?raw)