Report fields

An employee's work report is the object returned by the methods of the Work reports section. This page lists its fields, types and allowed values.

In the response of Read a work report, Create a work report, Update a work report, Submit a work report and Send a work report, the report arrives in the data field. In the response of List work reports, the reports are the elements of the data array, and the select parameter keeps id and the listed fields in each report. In the response of Subordinate work reports, data is an array of employees, and each employee's reports are the elements of their reports array. Dates are ISO 8601 strings in UTC or null. Keys inside tasks and events arrive in upper case.

Field	Type	Description
Fieldid	Typeinteger	DescriptionReport ID. List: GET /v1/workday/work-reports
FielduserId	Typeinteger	DescriptionID of the employee the report belongs to. List: GET /v1/users
Fieldactive	Typeboolean | null	DescriptionWhether the report is submitted: true — submitted, false — not. A report is submitted by Submit a work report and Send a work report
FieldreportType	Typestring | null	DescriptionLength of the report period: day — one day, week — two to seven days, month — more than seven days. null if the report has no period dates
FieldreportDate	Typestring | null	DescriptionWhen the report was created. Updating and submitting the report do not change it
FielddateFrom	Typestring | null	DescriptionFirst day of the report period, returned as the start of that day converted to UTC: October 6 in UTC+3 arrives as 2026-10-05T21:00:00.000Z
FielddateTo	Typestring | null	DescriptionLast day of the report period, in the same form. For a one-day report it equals dateFrom
Fieldreport	Typestring | null	DescriptionReport text from the reportText request field, with BB code markup. An HTML tag <i> sent in the text comes back as [i]
FieldreportPlain	Typestring | null	DescriptionReport text without markup
FieldreportExtended	Typestring | null	DescriptionAdditional report text. An empty string if there is none
Fieldtype	Typestring | null	DescriptionReport type: REPORT, AI_REPORT, ROBOT_REPORT, AI_DAY_PLAN or ROBOT_DAY_PLAN
Fieldplans	Typestring | null	DescriptionPlans. An empty string if there are none
Fieldtasks	Typearray | null	DescriptionTasks in the report. null if no tasks were sent, [] if the list was cleared with an empty array
Fieldtasks[].ID	Typeinteger	DescriptionTask ID. List: GET /v1/tasks
Fieldtasks[].TITLE	Typestring	DescriptionTask title in the report. Present if it was sent
Fieldtasks[].TIME	Typeinteger	DescriptionTime spent on the task, in seconds. Present if it was sent
Fieldevents	Typearray | null	DescriptionCalendar events in the report. null if no events were sent, [] if the list was cleared with an empty array
Fieldevents[].ID	Typeinteger	DescriptionCalendar event ID. List: GET /v1/calendar-events
Fieldevents[].TITLE	Typestring	DescriptionEvent title in the report. Present if it was sent
Fieldevents[].OWNER_ID	Typeinteger	DescriptionID of the event owner. Present if it was sent. List: GET /v1/users
Fieldfiles	Typearray | null	DescriptionReport files. The create and update methods do not accept files: a request with a files field in the body gets 400 INVALID_PARAMS
Fieldmark	Typestring | null	DescriptionReport mark: G — positive, B — negative, N — neutral or no mark yet, X — the report is not confirmed. Marks are set by Approve a work report, Disapprove a work report and Reject a work report; these methods never set X
Fieldapprove	Typestring | null	DescriptionReport confirmation. Y — the report is confirmed: after a positive or negative mark, or, for an employee without managers, right when the report is submitted or sent. N — no confirmation: the report is not submitted, is waiting for a mark or got a neutral one
FieldfromUser	Typeobject | null	DescriptionThe employee the report belongs to
FieldfromUser.id	Typeinteger	DescriptionEmployee ID, equal to userId. List: GET /v1/users
FieldfromUser.name	Typestring	DescriptionEmployee's first and last name
FieldfromUser.photo	Typestring | null	DescriptionProfile photo URL
FieldtoUsers	Typearray | null	DescriptionReport recipients: the employee's managers. For an employee without managers, the employee themselves
FieldtoUsers[].id	Typeinteger	DescriptionRecipient ID. List: GET /v1/users
FieldtoUsers[].name	Typestring	DescriptionRecipient's first and last name
FieldtoUsers[].photo	Typestring | null	DescriptionRecipient's profile photo URL
FieldisReadyForSubmit	Typeboolean | null	DescriptionWhether the report is ready to be submitted. Always null in the verified responses

See also

• Work reports
• List work reports
• Read a work report
• Daily reports
• Workday