---
title: "List users for the current company"
method: GET
path: "/api/users"
tags: ["Users - Admin"]
---

# List users for the current company

`GET /api/users`

Lists users belonging to the authenticated user's company.

By default only active users are returned. ``include_inactive=true`` also
returns excluded (soft-deleted, ativo=0) users, but ONLY for a company admin
— for anyone else (including system_admin/platform staff) the flag is coerced
to False so excluded colleagues are never exposed. Uses the same auth context
as /leads routes.

## Query parameters

- `team_id` integer, nullable — Optional team ID filter
- `include_inactive` boolean — Company-admin only: also include excluded (ativo=0) users. Silently ignored for non-admins.

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)