---
title: "List Users"
method: POST
path: "/users/grid"
tags: ["User"]
---

# List Users

`POST /users/grid`

Returns a paginated list of users with support for search, filter, and sort.

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `startTime` integer, required
- `endTime` integer, required

## Request body

- RmUserGridRequest — User Grid Request
  - `source` string[] — The source list
  - `site_ids` integer[] — The site IDs
  - `status` boolean — The status

## Response `200`

OK

- PagedRmUsersGridResponse
  - `page` integer, required — The current page number
  - `count` integer, required — The element count of the current page
  - `total_pages` integer, required — The total page number based on request page size
  - `total_count` integer, required — The total element count
  - `data` RmUsersGridResponse[] — The data in the current page
    - `status` boolean — The connection status of user
    - `site` string — The site where the user is located
    - `building` string — The building where the user is located
    - `floor` string — The floor where the user is located
    - `user_name` string — The Name of the user
    - `email` string — The Email address of the user
    - `group` string — Group to which the user belongs
    - `wireless_clients` integer — The number of wireless clients
    - `wired_clients` integer — The number of wired clients
    - `data_usage` integer — Total data usage in bytes
    - `source` string — 'Source of the session (e.g., RADIUS, SAML)'
    - `session_duration` integer — Duration of the session in seconds
    - `expiration` integer — Time in seconds until the session expires
    - `location_id` integer — The location ID
    - `user_id` integer — The User ID

---

[API](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/versions/5ff7ab84e8e8/schema)