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

# List Users

`GET /api_v2/users.json`

## Request

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

Returns all users (both team members and guests) in your organization. Use `updated_since` to retrieve only recently changed records.

## Query parameters

- `updated_since` string, date-time
- `page` integer

## Response `200`

List of users

- 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)