---
title: "List users"
method: GET
path: "/appReseller/v1/users"
tags: ["AppResellerAccount"]
---

# List users

`GET /appReseller/v1/users`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/appReseller/v1/users`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/appReseller/v1/users/get.ts> (a function with typed inputs; its response is checked against the schema)

In the Reseller Manager context, this request retrieves all Resellers and Referral users. In the Reseller context, it retrieves all users that belong to companies linked to the reseller.

## Query parameters

- `context` 'RESELLER' | 'RESELLER_MANAGER', required
- `partner` string
- `companyId` string
- `active` string[]
- `searchText` string
- `fromDate` string
- `toDate` string
- `sortField` 'CUSTOMER_ID' | 'EMAIL' | 'FIRST_NAME'
- `sortOrder` string
- `page` integer
- `size` integer

## Response `200`

Success

- UserPagedReadResponse
  - `content` UserCreationResponse[]: List of users
    - `id` string: User ID
    - `companyId` string: Current company ID
    - `email` string: Email address
    - `firstName` string: First name
    - `lastName` string: Last name
    - `createdOn` number: User creation date, in timestamp format
    - `activated` boolean: Indicates whether user is activated
    - `invitationRequired` boolean: Indicates whether the user requires an invitation
    - `enabled` boolean: Indicates whether the user is enabled
    - `memberships` AppResellerAccountUserCompanyMembershipWS[]: User company memberships
      - `company` AppResellerAccountCompanyWS
        - `id` string: Company ID
        - `externalId` string, nullable: Company's external ID
        - `name` string: Company name
        - `createdOn` number: Company creation date, in timestamp format
      - `enabled` boolean: Indicates whether user's company membership is enabled
      - `mosiUser` MosiUser, nullable
        - `username` string, nullable
      - `roles` Role[]: User roles in the Company
  - `page` PageMetadata
    - `number` number, required: Page number
    - `size` number, required: Size of the page to be returned
    - `totalElements` number, required: Total number of elements
    - `totalPages` number, required: Total number of pages

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `content` to the response with the `200` status
  - added the optional property `page` to the response with the `200` status

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appReseller/v1/users/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)