Admin Settings: Users

List admin users

List admin users

get/settings/users

Request

Query parameters

pageinteger
Example:1

Page (1-based).

per_pageinteger
Example:10

Items per page (default 10, max 50).

namestring

Filter by name (partial match).

emailstring

Filter by email (partial match).

role_idinteger

Filter by role ID.

status0 | 1

Filter by status (0/1).

sort'id' | 'name' | 'email'
Example:id

Sort column.

order'asc' | 'desc'
Example:desc

Sort direction.

Response

Paginated list in { data, meta } envelope.

idinteger nullable
namestring nullable
emailstring nullable
roleIdinteger nullable
roleNamestring nullable
statusinteger nullable
imagestring nullable
imageUrlstring nullable
createdAtstring nullable
updatedAtstring nullable
messagestring nullable

Example response

[
  {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "roleId": 1,
    "roleName": "Administrator",
    "status": 1,
    "image": "admins/1/avatar.png",
    "imageUrl": "https://your-domain.com/storage/admins/1/avatar.png",
    "createdAt": "2026-05-25T08:15:00+00:00",
    "updatedAt": "2026-05-25T08:20:00+00:00",
    "message": "User deleted successfully."
  }
]

Changes

No recorded changes to this operation across all 8 revisions of this API.