List Users

Retrieve a paginated list of all dashboard users (administrative staff) in the system. Dashboard users are employees who manage the car sharing platform through the admin dashboard, as opposed to clients who use the mobile app.

This endpoint returns users across all roles:

• Super Admins: Platform administrators with full access
• Partner Admins: Manage multiple agencies under a partner
• Agency Admins: Full control over a single agency
• Agency Staff: Limited access for day-to-day operations

Each user entry includes their organizational assignment (partner and/or agency) and last login time, useful for security audits and access management.

Super Admin Only

This endpoint requires the super_admin role. Partner and agency admins cannot view users outside their organization—use organization-specific user management endpoints instead.

Endpoint

INFO

GET /api/v1/dashboard/users

Headers

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

Query Parameters

Parameter	Type	Default	Description
role	string	-	Filter by role
search	string	-	Search by name or email
page	integer	1	Page number
per_page	integer	15	Items per page

Example Request

curl -X GET "https://api.daakey.com/api/v1/dashboard/users?role=agency_admin" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}"

Response

Success (200)

{
  "success": true,
  "message": "Users retrieved",
  "data": [
    {
      "id": 1,
      "name": "Super Admin",
      "email": "admin@daakey.com",
      "role": "super_admin",
      "status": "active",
      "partner": null,
      "agency": null,
      "last_login_at": "2024-01-15T09:00:00Z",
      "created_at": "2024-01-01T00:00:00Z"
    },
    {
      "id": 2,
      "name": "Partner Admin",
      "email": "admin@partner.com",
      "role": "partner_admin",
      "status": "active",
      "partner": {
        "id": 1,
        "name": "Acme Car Rentals"
      },
      "agency": null,
      "last_login_at": "2024-01-15T10:00:00Z",
      "created_at": "2024-01-05T00:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 2,
    "per_page": 15,
    "total": 20
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}