---
title: "List a user's companies"
method: GET
path: "/api/admin/user-companies/{userId}"
tags: ["Administration/User Companies"]
---

# List a user's companies

`GET /api/admin/user-companies/{userId}`

## Path parameters

- `userId` string, required

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, required
    - `companyId` string, required
    - `userId` string, required
    - `isPrimary` boolean, required
    - `hasAgreedWithTerms` boolean, required
    - `hasAgreedWithTermsAt` string, nullable, required
    - `userActivationLastNotifiedAt` string, nullable, required
    - `name` string, nullable, required
    - `officialName` string, nullable, required
    - `facilityProcesses` string, nullable, required
    - `isActiveCompany` number, required
  - `meta` object, required
    - `count` number, required
    - `page` number, required
    - `pageSize` number, required
    - `totalCount` number, required

## Other responses

- `401` — Default Response
- `403` — Default Response

## Changes

> 45 revisions in range; 1 not diffed.

- **2026-09-17** `b45b2427a621` — 2 breaking
  - removed the required property `data/items/role` from the response with the `200` status
  - removed the required property `data/items/roleName` from the response with the `200` status
- **2026-09-14** `3d3a05fa3548` — 1 breaking
  - the response property `data/items/role` became nullable for the status `200`
- **2026-09-13** `8049f7c86213` — 1 info
  - added the required property `data/items/roleName` to the response with the `200` status
- **2026-08-31** `97e51f27dc77` — 5 breaking, 5 info
  - the response property `data/items/facilityProcesses` became nullable for the status `200`
  - the response property `data/items/hasAgreedWithTermsAt` became nullable for the status `200`
  - the response property `data/items/name` became nullable for the status `200`
  - the response property `data/items/officialName` became nullable for the status `200`
  - …6 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/user-companies/:userId/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.dev/retraced/apis/api-reference/revisions/1045637f5ec0?raw)