---
title: "List company users"
method: GET
path: "/companies/{companyId}/users"
tags: ["Companies"]
---

# List company users

`GET /companies/{companyId}/users`

Returns the users with access to the company identified by `companyId`. The returned `id` matches the `userId` recorded on entities created manually in Embat (e.g. payments).

## Path parameters

- `companyId` string, required

## Response `200`

Successful Response

- ListCompanyUsersResponseSchema
  - `data` CompanyUserSchema[], required — Users with access to the company.
    - `id` string, required — Embat user ID.
    - `email` string, required — User's email address.
    - `updatedAt` string, date-time, nullable — Last updated date of the entity in the database
    - `createdAt` string, date-time, nullable — Created date of the entity in the database
    - `name` string, nullable — User's first name.
    - `surname` string, nullable — User's last name.

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Not found. The requested resource or `companyId` does not exist.
- `422` — Validation Error

---

[API](https://skmtc.net/embat/apis/embat-api.md) · [All operations](https://skmtc.net/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/embat/embat-api/revisions/6fd4a79f8f74/schema)