---
title: "List all customer users"
method: GET
path: "/v1/partner/customers/{customerId}/users"
tags: ["Customer Users"]
---

# List all customer users

`GET /v1/partner/customers/{customerId}/users`

## Request

- Base URL: `https://api.usemultiplier.com`
- URL: `https://api.usemultiplier.com/v1/partner/customers/{customerId}/users`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/docs/v1/partner/customers/:customerId/users/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a paginated list of all users associated with the customer.
Results are returned in descending order by creation date (newest first).

## Path parameters

- `customerId` object, required

## Query parameters

- `page` object
- `pageSize` object

## Response `200`

Customer users retrieved successfully

- StrategicPartnerCustomerUserListResponse
  - `data` StrategicPartnerCustomerUserResponse[], required: List of customer users
    - `id` string, required: Unique customer user identifier
    - `firstName` string: User's first name
    - `lastName` string: User's last name
    - `email` string, email, required: User's email address
    - `role` 'ADMIN' | 'BILLING_ADMIN' | 'PAYROLL_ADMIN' | 'HR_ADMIN' | 'MANAGER', required: User's role within the customer: - ADMIN: Administrator user to fully manage customer account - BILLING_ADMIN: Billing administrator user to manage customer billing - PAYROLL_ADMIN: Payroll administrator user to manage customer payroll - HR_ADMIN: HR administrator user to manage customer HR
    - `customerId` string, required: Customer ID this user belongs to
  - `pagination` StrategicPartnerPagination, required
    - `page` integer, required: Current page number (1-indexed)
    - `pageSize` integer, required: Number of items per page
    - `totalCount` integer, required: Total number of items across all pages
    - `totalPages` integer: Total number of pages (calculated from totalCount and pageSize)

## Other responses

- `400`: Bad Request - Validation failed
- `401`: Unauthorized - Missing or invalid authentication
- `404`: Not Found - Resource does not exist
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api.md) - [All operations](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/revisions/da31bb6ec00d?raw)