---
title: "Get a list of users"
method: GET
path: "/companies/{companyId}/users"
tags: ["Users - company level"]
---

# Get a list of users

`GET /companies/{companyId}/users`

Returns the list of users for the `companyId` identified in the path.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Users read and write

## Path parameters

- `companyId` string, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `username` string

## Response `200`

OK - the request has succeeded.

- ListCompanyUsersResponse
  - `_links` PaginationLinks
    - `first` LinksElement, required
      - `href` string
    - `last` LinksElement, required
      - `href` string
    - `next` LinksElement
      - `href` string
    - `prev` LinksElement
      - `href` string
    - `self` LinksElement, required
      - `href` string
  - `data` CompanyUser[] — The list of users.
    - `_links` Links
      - `self` LinksElement, required
        - `href` string
    - `accountGroups` string[] — The list of [account groups](https://docs.adyen.com/account/account-structure#account-groups) associated with this user.
    - `active` boolean — Indicates whether this user is active.
    - `apps` string[] — Set of apps available to this user
    - `associatedMerchantAccounts` string[] — The list of [merchant accounts](https://docs.adyen.com/account/account-structure#merchant-accounts) associated with this user.
    - `email` string, required — The email address of the user.
    - `id` string, required — The unique identifier of the user.
    - `name` Name
      - `firstName` string, required — The first name.
      - `lastName` string, required — The last name.
    - `roles` string[], required — The list of [roles](https://docs.adyen.com/account/user-roles) for this user.
    - `timeZoneCode` string, required — The [tz database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of the time zone of the user. For example, **Europe/Amsterdam**.
    - `username` string, required — The username for this user.
  - `itemsTotal` integer, required — Total number of items.
  - `pagesTotal` integer, required — Total number of pages.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

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