Search Users

Advanced user search with filtering.

Quick Navigation

• Endpoint
• Headers
• Request Body
• Response
  • Success (200)
• Features
• Status

Endpoint

POST /api/v1/users/search

Headers

Header	Required	Description
Authorization	Yes	Bearer <access_token>
Content-Type	Yes	application/json

Request Body

{
  "query": "john",
  "filters": {
    "status": "active",
    "role_id": 2
  },
  "sort_by": "created_at",
  "sort_order": "desc",
  "skip": 0,
  "limit": 50
}

Response

Success (200)

{
  "success": true,
  "data": {
    "users": [
      {
        "id": 123,
        "email": "john@example.com",
        "display_name": "John Doe"
      }
    ],
    "total_count": 5,
    "message": "Search completed successfully"
  },
  "message": "Search completed successfully"
}

Features

• Advanced search filters
• Sorting options
• Export capabilities

Status

[WARNING] TODO: Not Implemented

This endpoint is defined in the router but the implementation logic is not yet complete.