ReportsReport types and columns

Totals per agent

One row per agent for the period: days worked, hours, gap to contract.

GET /api/v1/reports/agents?activity=AC-0001&week=2026-W47

64 columns

Ask for columns with fields, in the order you want. Without fields you get the ones marked Default.

  • activity_code
    Activity codeDefault
  • agent_id
    Agent IDDefault
  • agent_code
    Agent codeDefault
  • contract_id
    Contract IDDefault
  • contract_type
    ContractDefault
  • days_worked
    Days workedDefault
  • shift_time
    Scheduled timeDefault

    Sum of shift lengths, breaks included

  • paid_time
    Paid timeDefault

    Shift time minus unpaid breaks, plus paid time off

  • contract_gap
    Gap to contractDefault

    Paid time minus contract hours due

  • agent_name
    AgentPersonal
  • agent_email
    EmailPersonal
  • agent_phone
    PhonePersonal
  • agent_country
    Country
  • agent_status
    Agent status
  • agent_timezone
    Agent timezone
  • supervisors
    SupervisorsPersonal

    The team in force on the row's day, or during its week or period

  • contract_weekly
    Contract hours / week
  • contract_start
    Contract start
  • contract_end
    Contract end
  • contract_max_daily
    Max hours / day
  • contract_max_days
    Max days / week
  • contract_vacation_days
    Vacation days / year
  • first_day
    First day worked
  • last_day
    Last day worked
  • shift_count
    Shifts
  • weekend_days
    Weekend days worked
  • avg_shift
    Average shift
  • break_count
    Breaks
  • break_paid
    Paid breaks
  • break_unpaid
    Unpaid breaks
  • lunch_time
    Lunch time
  • coffee_time
    Coffee breaks
  • productive_time
    Productive time

    Shift time minus all breaks and meetings

  • meeting_time
    Meetings
  • night_time
    Night hours (9pm–6am)

    Part of the shifts between 9pm and 6am

  • time_off_paid
    Paid time off
  • time_off_unpaid
    Unpaid time off
  • contract_target
    Contract hours due

    Weekly contract hours, prorated to the period

  • late_count
    Late startsLive only
  • late_minutes
    Time lateLive only

    Total of late starts

  • missed_shifts
    Missed shiftsLive only
  • client_name
    Client
  • activity_name
    Activity
  • planning_title
    Planning

    The plannings the row's shifts come from

  • planning_label
    Planning label

    Client - Activity - S43 - 2026, the same for every activity, for rows inside one week

  • source
    Source
  • contract_type_id
    Contract type ID
  • client_code
    Client code
  • client_id
    Client ID
  • activity_id
    Activity ID
  • planning_id
    Planning ID
  • supervisor_ids
    Supervisor IDs

    IDs of the same supervisors, as in the Supervision page address

Columns for grouped rows

/reports/agents normally gives one row per agent for the whole period. With group_by=week you get one row per agent per ISO week (Monday to Sunday); with group_by=month, one row per agent per calendar month. This is the layout of weekly production feeds such as WIP.

  • week
    Weekgroup_by=week

    ISO week of the row, such as 2026-W42

  • week_number
    Week numbergroup_by=week

    ISO week number of the row, such as 42

  • month
    Monthgroup_by=month

    Month of the row, such as 2026-10

  • period_start
    Period startgroup_by=week · group_by=month

    First day the row covers (cut to the requested period)

  • period_end
    Period endgroup_by=week · group_by=month

    Last day the row covers (cut to the requested period)

  • monday
    Mondaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

  • tuesday
    Tuesdaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

  • wednesday
    Wednesdaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

  • thursday
    Thursdaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

  • friday
    Fridaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

  • saturday
    Saturdaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

  • sunday
    Sundaygroup_by=week

    The day's value (day_value, paid time by default); empty outside the period

Custom fields

Your workspace's custom fields are columns too: cf.<key> for agent fields and ccf.<key> for client fields. Numbers come without units. GET /reports lists them with their ids.

Totals per agent — Planifizer API docs