ApiUsers
Advanced search for users
GET
Search users with filters (search query, active status), sorting, and pagination.
bearersearch?stringSearch query for name or email
isActive?stringFilter by active status
sortBy?stringSort by field
Value in
"email""firstName""lastName""createdAt""isActive"sortOrder?stringSort direction
Value in
"asc""desc"page?numberPage number
Range
1 <= valuelimit?numberItems per page
Range
1 <= valueX-API-Version?stringAPI version for header-based versioning
Default
"1"Value in
"1""2"Users search results with filters and pagination.
response?unknownapplication/jsoncurl -X GET 'http://localhost:3001/api/v1/users/search/advanced'Example Response200
{ "status": "success", "statusCode": 200, "message": "Users searched 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": 15, "count": 10, "page": 1, "limit": 10, "total_pages": 2, "has_next": true, "has_previous": false, "search_query": "john", "filters": { "isActive": "true" }, "sort": { "field": "email", "order": "asc" } }, "timestamp": "2026-01-27T10:40:00.000Z", "path": "/api/v1/users/search/advanced"}