Client Statistics

Retrieve statistics for clients.

Endpoint

INFO

GET /api/v1/dashboard/clients-stats

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes

Query Parameters

Parameter	Type	Default	Description
period	string	month	Period: day, week, month, year

Example Request

curl -X GET "https://api.daakey.com/api/v1/dashboard/clients-stats?period=month" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}"

Response

Success (200)

{
  "success": true,
  "message": "Client statistics retrieved",
  "data": {
    "summary": {
      "total_clients": 500,
      "active_clients": 450,
      "suspended_clients": 10,
      "unverified_clients": 40
    },
    "growth": {
      "new_clients": 45,
      "trend": "+12%"
    },
    "verification": {
      "fully_verified": 380,
      "partial_verified": 80,
      "unverified": 40
    },
    "engagement": {
      "clients_with_bookings": 320,
      "repeat_customers": 250,
      "retention_rate": 78.1
    },
    "top_clients": [
      {
        "id": 1,
        "name": "John Doe",
        "bookings_count": 15,
        "total_spent": 1250.00
      },
      {
        "id": 5,
        "name": "Jane Smith",
        "bookings_count": 12,
        "total_spent": 980.00
      }
    ],
    "by_registration_source": {
      "mobile_app": 350,
      "web": 150
    },
    "currency": "USD"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}