# 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.

## Endpoint

`GET /emsapi/users/info`

## Request

### Request URL

`https://{server-hostname}:8383/emsapi/users/info`

### Scope

`Admin.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

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

## Response Parameters

### HTTP code 200

#### Response Body — application/json

**JSON object**

- **metadata** — JSON object

  Pagination metadata describing the current page and applied limit.

- **totalRecords** — string

  Total number of users available across all pages.

- **messageResponse** — JSON array

  Paginated list of user detail objects.

- **totalPages** — integer

  Total number of pages for the current page limit.

- **Links** — JSON object

  Pagination navigation links for next and previous pages.

- **status** — string

  Operation result indicator.

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

Paginated list of users with role and status details.

```json
{
  "metadata": {
    "limit": 25,
    "page": 1
  },
  "totalRecords": "3",
  "messageResponse": [
    {
      "creation_time": "Nov 3, 2025 01:13 PM",
      "login_id": "1",
      "modified_time": "Nov 3, 2025 01:13 PM",
      "domainname": "Local",
      "emailid": "alex.morgan@example.com",
      "um_role_name": "Security Auditor",
      "landline": "22222676",
      "first_name": "Alex Morgan",
      "created_by": "1",
      "status": "Not Active"
    },
    {
      "creation_time": "Nov 3, 2025 01:13 PM",
      "login_id": "302",
      "modified_time": "Nov 3, 2025 01:13 PM",
      "domainname": "Local",
      "emailid": "priya.shah@example.com",
      "um_role_name": "Security Auditor",
      "landline": "22222676",
      "first_name": "Priya Shah",
      "created_by": null,
      "status": "Not Active"
    },
    {
      "creation_time": "Nov 3, 2025 01:13 PM",
      "login_id": "301",
      "modified_time": "Nov 3, 2025 01:13 PM",
      "domainname": "Local",
      "emailid": "daniel.lee@example.com",
      "um_role_name": "Security Auditor",
      "landline": "22222676",
      "first_name": "Daniel Lee",
      "created_by": null,
      "status": "Not Active"
    }
  ],
  "totalPages": 1,
  "Links": {
    "next": null,
    "prev": null
  },
  "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.