---
title: "List users (org members)"
method: GET
path: "/users"
tags: ["Catalog"]
---

# List users (org members)

`GET /users`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/users`
- Auth: HTTP bearer

Read-only. Returns every employee in the calling token's org plus the list of team ids each one belongs to.

## Response `200`

All users in the calling token's org

- object
  - `users` User[]
    - `id` string, required: Firebase Auth uid.
    - `email` string, nullable
    - `displayName` string, nullable
    - `role` string, nullable: Org role — owner / admin / member / viewer.
    - `isActive` boolean, required
    - `avatarKey` string, nullable
    - `avatarBgColor` string, nullable
    - `avatarFontColor` string, nullable
    - `teamIds` string[], required: Ids of every team the user belongs to.
    - `lastLoginAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `401` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)
