# Retrieve a paginated list of all users in the organization

Retrieves a paginated list of all users configured in the organization, including their login ID, role, email, phone number, creation time, and account status. Supports page-based pagination.

## Endpoints

`GET` `/emsapi/users/info`

## Request URL

`https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/emsapi/users/info`

## Scope

`DesktopCentralCloud.Admin.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Query Parameters

- **page** `integer` *(Optional)*: Page number for pagination. Starts from 1. Returns the first page if not specified.
- **pageLimit** `integer` *(Optional)*: Maximum number of user records to return per page. Uses system default of 25 if not specified.The maximum allowed value is 1000.

## Sample Request

### Curl

```curl
curl --request GET \
  --url https://appdomains/emsapi/users/info \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

`JSON Object`

- **metadata** `JSON Object`: Pagination metadata describing the current page and limit applied.
- **totalRecords** `string`: Total number of user records available in the organization across all pages.
- **messageResponse** `JSON Array`: Paginated list of user detail objects returned for the current page.
- **totalPages** `integer`: Total number of pages available based on totalRecords and the current page limit.
- **Links** `JSON Object`: Navigation links for moving to the next or previous page of results.
- **status** `string`: Response status. `'success'` confirms the user list was fetched successfully.

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

Page 1 of users with the default limit of 25. Links.next and Links.prev are null when only one page exists.

```json
{
  "metadata": {
    "limit": 25,
    "page": 1
  },
  "totalRecords": "3",
  "messageResponse": [
    {
      "creation_time": "Nov 3, 2025 12:26 PM",
      "login_id": "9502000000134133",
      "modified_time": "Nov 3, 2025 12:26 PM",
      "um_role_id": "9502000000014452",
      "phonenumber": "12312312131",
      "um_role_name": "Security Auditor",
      "email": "alex.morgan@example.com",
      "username": "alex.morgan",
      "status": "1"
    },
    {
      "creation_time": "Nov 3, 2025 12:26 PM",
      "login_id": "9502000000122681",
      "modified_time": "Nov 3, 2025 12:26 PM",
      "um_role_id": "9502000000014452",
      "phonenumber": "1231231231",
      "um_role_name": "Endpoint Administrator",
      "email": "jamie.chen@example.com",
      "username": "jamie.chen",
      "status": "1"
    },
    {
      "creation_time": "Nov 3, 2025 12:26 PM",
      "login_id": "9502000000120677",
      "modified_time": "Nov 3, 2025 12:26 PM",
      "um_role_id": "9502000000014452",
      "phonenumber": "",
      "um_role_name": "Service Desk Operator",
      "email": "service.desk@example.com",
      "username": "service.desk",
      "status": "1"
    }
  ],
  "totalPages": 1,
  "Links": {
    "next": null,
    "prev": null
  },
  "status": "success"
}
```

Page 2 result when multiple pages exist. Links.prev points to page 1; Links.next is null on the last page.

```json
{
  "metadata": {
    "limit": 25,
    "page": 2
  },
  "totalRecords": "30",
  "messageResponse": [
    {
      "creation_time": "Nov 5, 2025 09:10 AM",
      "login_id": "9502000000145001",
      "modified_time": "Nov 5, 2025 09:10 AM",
      "um_role_id": "9502000000014453",
      "phonenumber": "",
      "um_role_name": "Endpoint Technician",
      "email": "priya.shah@example.com",
      "username": "priya.shah",
      "status": "1"
    }
  ],
  "totalPages": 2,
  "Links": {
    "next": null,
    "prev": "/emsapi/users/info?page=1&pageLimit=25"
  },
  "status": "success"
}
```

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.