---
title: "Get Company Migration Users"
method: GET
path: "/internal/migration/companies/{company_id}/users"
tags: ["internal"]
---

# Get Company Migration Users

`GET /internal/migration/companies/{company_id}/users`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/internal/migration/companies/{company_id}/users`
- Auth: none declared

Active users in a company with their current role attachments, plus the company's own
roles as move targets. Drives the "move users onto their custom role" flow.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- MigrationCompanyUsersResponse
  - `company_id` string, required
  - `company_name` string, required
  - `users` MigrationUserRow[], required
    - `user_id` string, required
    - `email` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `roles` MigrationUserRole[], required
      - `role_id` string, required
      - `role_name` string, required
      - `scope` string, required
      - `archetype` 'tprm_admin' | 'business_owner' | 'tprm_analyst' | 'sme' | 'view_only' | 'collateral_admin' | 'collateral_reviewer' | 'collateral_submitter' | 'policy_reviewer': Closed, product-owned set of role identities. Stable machine keys — never renamed.
      - `module` string, nullable
    - `on_global` boolean, required
  - `company_roles` CompanyRoleOption[], required
    - `role_id` string, required
    - `role_name` string, required
    - `archetype` 'tprm_admin' | 'business_owner' | 'tprm_analyst' | 'sme' | 'view_only' | 'collateral_admin' | 'collateral_reviewer' | 'collateral_submitter' | 'policy_reviewer': Closed, product-owned set of role identities. Stable machine keys — never renamed.
    - `module` string, nullable
  - `global_roles` CompanyRoleOption[], required
    - `role_id` string, required
    - `role_name` string, required
    - `archetype` 'tprm_admin' | 'business_owner' | 'tprm_analyst' | 'sme' | 'view_only' | 'collateral_admin' | 'collateral_reviewer' | 'collateral_submitter' | 'policy_reviewer': Closed, product-owned set of role identities. Stable machine keys — never renamed.
    - `module` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/fastapi.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/fastapi/revisions/8587332d5e43?raw)