---
title: "Get Hosts for a Site"
method: GET
path: "/v2/guest/hosts"
tags: ["Hosts"]
---

# Get Hosts for a Site

`GET /v2/guest/hosts`

Returns hosts for a specific Guest site.

If email is provided, returns the corresponding host with a matching email.
Otherwise, returns a paginated list of hosts for the site.

## Query parameters

- `site_id` string, uuid, required — The unique identifier of the Guest site. Valid sites can be retrieved with the Guest Site API.
- `email` string — Optional email filter. If provided, only returns the host matching this email.
- `cursor` string — Pagination cursor for retrieving the next page of results.
- `limit` integer — Maximum number of hosts to return. Default is 100, maximum is 200.

## Response `200`

OK

- HostResponse — Response containing a list of hosts
  - `cursor` string — Pagination cursor for retrieving the next page of results.
  - `items` HostResponseItemV2[], required — List of hosts.
    - `email` string — The email of the host.
    - `first_name` string, required — The preferred first name of the host. If none is specified by the host, the same as original_first_name.
    - `full_name` string, required — The full name of the host.
    - `has_delegate` boolean, required — Whether the host has a delegate assigned.
    - `host_id` string, uuid, required — The unique identifier of the host.
    - `last_name` string, required — The last name of the host.
    - `original_first_name` string, required — The original first name of the host.
    - `phone_number` string — The phone number of the host.
    - `requires_host_approval` boolean, required — Whether the host requires host approval on all visits.

---

[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/revisions/4a79d2d949a6/schema)