---
title: "GET /api/user-companies/companies-to-switch"
method: GET
path: "/api/user-companies/companies-to-switch"
tags: ["User Companies"]
---

# GET /api/user-companies/companies-to-switch

`GET /api/user-companies/companies-to-switch`

Every other company the authenticated user belongs to, for the account switcher — excludes the caller's current company.

## Response `200`

Default Response

- object[]
  - `id` string, required
  - `companyId` string, required
  - `userId` string, required
  - `role` string, required
  - `isPrimary` boolean, required
  - `hasAgreedWithTerms` boolean, required
  - `hasAgreedWithTermsAt` string, nullable, required
  - `userActivationLastNotifiedAt` string, nullable, required
  - `name` string, required
  - `officialName` string, required
  - `isDemoCompany` number, required
  - `isClientCompany` number, required

## Other responses

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

## Changes

> 23 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 2 breaking, 2 info
  - the response property `items/hasAgreedWithTermsAt` became nullable for the status `200`
  - the response property `items/userActivationLastNotifiedAt` became nullable for the status `200`
  - response property `items/hasAgreedWithTermsAt` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `items/userActivationLastNotifiedAt` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/user-companies/companies-to-switch/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/fde251beb0ca/schema)