Overheads

For more details about what overheads are, please refer to the help article.

The Overhead object represents overhead costs for a particular month of a fiscal year. Productive generates overhead objects automatically every month, starting the month when you opened your Productive account.

Please note that some overhead settings are also defined at the organisation level. This settings can be changed by modifying the Organizations object.

Attributes

averaging_period integer
Response Request

The number of past overhead periods used to calculate projected estimates when averaging is enabled.

capacity number
Response

The total available work capacity in hours for the period, based on employee schedules.

client_hours number
Response

Total hours tracked on billable client projects during this overhead period.

client_overhead_hours number
Response

Hours tracked on billable client projects that are marked as overhead during this period.

currency string
Response

The currency of monetary values in this overhead record.

currency_default object
Response

The monetary values in this overhead record converted to the organization's default currency.

currency_normalized object
Response

The monetary values in this overhead record in the normalized (display) currency.

ended_on string
Response Parameter `sort`

Date when this overhead period ends, or null if this is the current projection period.

exchange_rate number
Response

The exchange rate used to convert costs to the organization's default currency for this period.

facility_cost_per_hour object
Response

The facility cost per hour.

facility_cost_per_hour_default object
Response

The facility cost per hour default.

facility_cost_per_hour_normalized object
Response

The facility cost per hour normalized.

facility_costs integer
Response Request

The total facility (office and infrastructure) costs allocated to this overhead period.

facility_costs_breakdown object
Response Request

A breakdown of facility costs by category (e.g. rent, utilities) for this overhead period.

facility_costs_default object
Response

The facility costs converted to the organization's default currency.

facility_costs_normalized object
Response

The facility costs in the normalized (display) currency.

internal_componentized_costs object
Response

The total internal costs including work, time-off, and expenses, adjusted for overhead inclusion controls.

internal_componentized_costs_default object
Response

The internal componentized costs default.

internal_componentized_costs_normalized object
Response

The internal componentized costs normalized.

internal_expense_costs object
Response

The total cost of internal expense reports during this overhead period.

internal_expense_costs_default object
Response

The internal expense costs default.

internal_expense_costs_normalized object
Response

The internal expense costs normalized.

internal_hours number
Response

Total hours tracked on internal (non-billable) projects during this overhead period.

internal_overhead_hours number
Response

Hours tracked on internal projects that are marked as overhead during this period.

internal_work_costs object
Response

The total cost of time tracked on internal projects during this overhead period.

internal_work_costs_default object
Response

The internal work costs default.

internal_work_costs_normalized object
Response

The internal work costs normalized.

new_internal_cost_per_hour object
Response

The new internal cost per hour.

new_internal_cost_per_hour_default object
Response

The new internal cost per hour default.

new_internal_cost_per_hour_normalized object
Response

The new internal cost per hour normalized.

organization organization
Response

The organization this overhead record belongs to.

overhead_controls object
Response Request

A set of flags controlling which overhead types (facility, work, time-off, expense, undertime, overtime) are included in cost calculations.

overhead_hours number
Response

Total hours marked as overhead across all project types during this period.

overtracked_costs object
Response

The cost associated with overtracked hours — when employees tracked more time than their scheduled capacity.

overtracked_costs_default object
Response

The overtracked costs converted to the organization's default currency.

overtracked_costs_normalized object
Response

The overtracked costs in the normalized (display) currency.

overtracked_hours number
Response

Hours tracked in excess of the employee's scheduled capacity during this period.

recalculated_at string
Response

Timestamp when the overhead costs were last recalculated from tracked time and bookings.

recalculating_status object
Response

The current recalculation status of this overhead, tracking whether bookings and time entries have been processed.

started_on string
Response Parameter `sort`

Date when this overhead period starts.

subsidiary subsidiary
Response

The subsidiary this overhead record is associated with (null for global overheads).

subsidiary_id integer
Parameter `filter`

ID of the subsidiary this overhead record is associated with (null for global overheads).

time_off_costs object
Response

The total cost of paid time-off hours during this overhead period.

time_off_costs_default object
Response

The time off costs default.

time_off_costs_normalized object
Response

The time off costs normalized.

time_off_hours number
Response

Total paid time-off hours taken by employees during this overhead period.

time_off_overhead_hours number
Response

The time off overhead hours.

total_hours number
Response

Total hours tracked across all project types during this overhead period.

undertracked_costs object
Response

The cost associated with undertracked hours — when employees tracked less time than their scheduled capacity.

undertracked_costs_default object
Response

The undertracked costs converted to the organization's default currency.

undertracked_costs_normalized object
Response

The undertracked costs in the normalized (display) currency.

undertracked_hours number
Response

Hours not tracked by employees relative to their scheduled capacity during this period.

updated_at string
Response

Timestamp when this overhead record was last updated.

updater person
Response

The person who last updated this overhead record.

use_overhead boolean
Response Request

When true, overhead calculations are enabled and applied to cost rate computations for this subsidiary.

uses_averaging boolean
Response

When true, overhead costs are averaged over multiple past periods rather than using a single period's values.