---
title: "GET /api/user-companies/list-by-company-ids"
method: GET
path: "/api/user-companies/list-by-company-ids"
tags: ["User Companies"]
---

# GET /api/user-companies/list-by-company-ids

`GET /api/user-companies/list-by-company-ids`

Users belonging to any of the given companies. Unscoped — any authenticated caller may query any company's users. `notAdmin=true` additionally excludes Retraced-staff roles and projects `email`.

## Query parameters

- `companyIds` string, required
- `notAdmin` union
  - boolean
  - string

## Response `200`

Default Response

- object[]
  - `id` string, required
  - `firstName` string, nullable, required
  - `lastName` string, nullable, required
  - `companyId` string, required
  - `isBlocked` number, required
  - `developmentTag` string, nullable, required
  - `hasAgreedWithTerms` boolean, required
  - `emailPreferences` unknown, required
  - `email` string

## Other responses

- `400` — Default Response
- `401` — Default Response

## Changes

> 24 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 4 breaking, 4 info
  - the response property `items/developmentTag` became nullable for the status `200`
  - the response property `items/emailPreferences` became nullable for the status `200`
  - the response property `items/firstName` became nullable for the status `200`
  - the response property `items/lastName` became nullable for the status `200`
  - …4 more
- **2026-08-12** `ac2cf3c5eae2` — 1 breaking
  - the `items/hasAgreedWithTerms` response's property type/format changed from `number`/`` to `boolean`/`` for status `200`

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/user-companies/list-by-company-ids/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/0bff3edc7b79/schema)