The Productivity & Activity API returns per-employee productivity metrics, activity levels, and time breakdowns based on your configured Productivity Rules.
Endpoint
POST: https://api.ag.prodoscore.com/query/productivity/productivity_employee_list
Request Payload
Key Parameters
datewise (boolean): When false, returns summary metrics for the entire date range. When true, returns one row per employee per day.
summary (boolean): When true, aggregates by employee. When false, includes per-category breakdowns.
Optional Filters:
cat_name— Filter to a specific application category (e.g., "Social Media", "Productivity Tools")app— Filter to a specific application nameurl— Filter to a specific website/URLattendance_type— Filter by attendance type (e.g., "present", "absent")
Response Fields
Each record includes:
employee_id— Unique employee identifieremployee_name— Full nameemail— Employee emailteam_name— Team/group namedate— Date (if datewise: true)online_duration— Total seconds employee was onlineactive_duration— Seconds with keyboard/mouse activityidle_duration— Seconds with no activitybreak_duration— Seconds spent in configured breakskey_presses— Total number of key pressesmouse_clicks— Total number of mouse clicksproductive_duration— Seconds spent on productive apps/URLsunproductive_duration— Seconds spent on unproductive apps/URLsneutral_duration— Seconds spent on neutral apps/URLsproductivity_percentage— (productive_duration / active_duration) * 100active_percent— (active_duration / online_duration) * 100shift_time— Expected shift duration in seconds
Example Response (Summary Mode)
Calculating Productivity
Productivity percentage is calculated as:
Note: Idle time does not count in the denominator. If an employee is idle for 1 hour (even if a productive app is open), that hour does not improve their productivity score. Productivity measures active work on productive tools, not mere presence.
