---
title: "User List"
method: GET
path: "/api/mdm/user_list"
tags: ["MDM"]
---

# User List

`GET /api/mdm/user_list`

**Function**: `user_list`
**Type**: API Endpoint (GET)

**Purpose**:  
This function retrieves a paginated list of users who have MDM access for a specific `LSCode`. It decodes the `LSCode` from the request headers, queries the database for user details, and returns a JSON response containing the user information.

**URL**:  
`GET /api/mdm/user_list/?page=<page_num>&limit=<limit_num>`

**Request Headers**:
- **Customer_Key** (Header, required):  
  A base64 encoded string that identifies the Customer_Key(LSCode|FirmCode).

**Request Parameters**:
- **page** (Query Parameter, optional):  
  The page number for pagination (default is 1).
- **limit** (Query Parameter, optional):  
  The number of rows to fetch per page for pagination (default is 25).

**Response Example**:
```json
{
    "users": [
        {
            "Name": "<First Name>",
            "Email": "<Email>",
            "Mobile": "<Mobile>",
            "Role": "<User Group Name>",
            "Status": "<Isactive>",
            "UserCode": "<Encoded User Code>",
            "groupCode": "<Encoded Group Code>"
        },
        ...
    ]
}
```

**Error Handling**:
- Raises HTTP 400 if `lscode` header is missing.
- Raises HTTP 500 for any other exceptions encountered during execution.

## Query parameters

- `page` integer
- `limit` integer

## Headers

- `Customer-Key` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/leapsurgebi/apis/leapsurgeapi.md) · [All operations](https://skmtc.dev/leapsurgebi/apis/leapsurgeapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leapsurgebi/leapsurgeapi/revisions/5a6b1464bfeb/schema)