ApiUsers
Get all users with pagination (Admin/Moderator)
GET
Retrieves a paginated list of users. Use page and limit query parameters to control pagination. Requires Admin or Moderator role.
bearerpage?numberPage number (default: 1)
limit?numberItems per page (default: 10)
X-API-Version?stringAPI version for header-based versioning
Default
"1"Value in
"1""2"Return all users with pagination.
response?unknownapplication/jsoncurl -X GET 'http://localhost:3001/api/v1/users'Example Response200
{ "status": "success", "statusCode": 200, "message": "Users fetched successfully", "data": [ { "id": "6dd9ca2a-4a9f-4155-ad34-4cf6a575eebe", "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe", "isActive": true, "createdAt": "2026-01-27T10:23:22.983Z", "updatedAt": "2026-01-27T10:23:22.983Z" } ], "meta": { "total": 25, "count": 10, "page": 2, "limit": 10, "total_pages": 3, "has_next": true, "has_previous": true, "timestamp": "2026-01-27T10:28:36.014Z" }, "timestamp": "2026-01-27T10:28:36.014Z", "path": "/api/v1/users"}Create a new user (Admin only) POST
Creates a new user with email, first name, last name, and password. Password must be at least 8 characters with uppercase, lowercase, number, and special character. Requires Admin role.
Get a user by ID GET
Retrieves a single user by their UUID. Returns cached data if available.