---
title: "List Guests"
method: GET
path: "/api_v2/users/guests.json"
tags: ["Users"]
---

# List Guests

`GET /api_v2/users/guests.json`

## Request

- Base URL: `https://www.bugherd.com`
- URL: `https://www.bugherd.com/api_v2/users/guests.json`
- Auth: HTTP basic

Returns all guest users across your organization. Guests are external collaborators who have been invited to specific projects.

## Query parameters

- `page` integer

## Response `200`

List of guests

- object
  - `users` User[]
    - `id` integer
    - `email` string, email
    - `display_name` string
    - `avatar_url` string, uri
  - `meta` object
    - `count` integer: Total number of records across all pages

---

[API](https://skmtc.dev/bugherd/apis/bugherd-api-v2.md) · [All operations](https://skmtc.dev/bugherd/apis/bugherd-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/bugherd/apis/bugherd-api-v2/revisions/bf473cda70d4?raw)