---
title: "Get Guest Events for a Site"
method: GET
path: "/v2/guest/guest_events"
tags: ["Events"]
---

# Get Guest Events for a Site

`GET /v2/guest/guest_events`

Returns a paginated list of Guest events and their event parts for a site within a time range.

Guest events allow organizations to pre-register and manage visitors for specific events.
See https://help.verkada.com/guest/configuration-and-setup/guest-events for more information.

## Query parameters

- `site_id` string, uuid, required — The unique identifier of the Guest site. Valid sites can be retrieved with the Guest Site API.
- `start_time` string, required — The start time to look for events and their event parts in ISO 8601 format (e.g., '2025-01-17T21:06:20Z').
- `end_time` string, required — The end time to look for events and their event parts in ISO 8601 format (e.g., '2025-01-17T22:06:20Z').
- `limit` integer — Maximum number of items to return. Default is 100, maximum is 200.
- `cursor` string — Pagination cursor for retrieving the next page of results.

## Response `200`

OK

- EventListResponseV2 — Response containing a list of events and event parts
  - `cursor` string — Pagination cursor for retrieving the next page of results.
  - `items` EventPartItemV2[], required — List of events, their event parts and invitees.
    - `end_time` string, required — The end time for the event or event part in RFC 3339 format (e.g., '2025-01-17T21:06:20+00:00').
    - `event_name` string, required — The name of the Event. Defaults to 'New Event' if not specified in creation.
    - `event_part_id` string, uuid — The unique identifier for an event part of a multi-day event. Null if a single-day event.
    - `guest_event_id` string, uuid, required — The unique identifier for a Guest event.
    - `is_multipart` boolean, required — Whether this is a multi part event.
    - `start_time` string, required — The start time for the event or event part in RFC 3339 format (e.g., '2025-01-17T21:06:20+00:00').

---

[API](https://skmtc.net/verkada/apis/api-tokens.md) · [All operations](https://skmtc.net/verkada/apis/api-tokens/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verkada/api-tokens/versions/4a79d2d949a6/schema)