List users

Platform

Retrieve users visible in the active tenant context with role-aware filtering and pagination.

Identity

One user identity

Membership

Tenant affiliation

Role

Functional access

Context

Tenant + membership

GET/v1/usersScope: users.read

Endpoint summary

GET /v1/users requires users.read and returns only users visible in the active tenant context.

Name	Type	Description
status	string	Optional membership/user status filter
role	string	Filter by role in the active tenant
page	integer	Page number
limit	integer	Items per page

cURLCopy

GET https://api.mediloop.com/v1/users?status=active&page=1&limit=25
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: tnt_123
X-Membership-Id: mbr_456

JSONCopy

{
  "data": [{ "id": "usr_123", "display_name": "Dr. Sarah Müller" }],
  "meta": { "page": 1, "limit": 25 }
}

Visibility is tenant-scoped and permission-checked. A caller cannot enumerate global Mediloop users.