Odoo 19.0 Community · Persistent

hr.department: fields, relations and API

The hr.department model ("Department") is a persistent model declared by the Employees module, then extended by 4 other modules. It exposes 54 fields, 25 of them declared directly on the model; 26 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: hr.department
Label: Department
Type: Persistent (models.Model)
SQL table: hr_department
Origin module: Employees (hr)
Extended by: hr_expense, hr_holidays, hr_recruitment, website_hr_recruitment
Default order (_order): name
Display field (_rec_name): complete_name
Inherits from (mixins): mail.thread mail.activity.mixin

Model fields

25 own fields, 24 inherited from mixins and 5 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

54 of 54 fields shown

Technical name	Label	Type	Details
absence_of_today	Absence by Today	`integer`	computed added by Time Off (`hr_holidays`)
active	Active	`boolean`
allocation_to_approve_count	Allocation to Approve	`integer`	computed added by Time Off (`hr_holidays`)
child_ids	Child Departments	`one2many` → hr.department	inverse: `parent_id`
color	Color Index	`integer`
company_id	Company	`many2one` → res.company	computed, stored
complete_name	Complete Name	`char`	computed
display_name	Display Name	`char`	added by Online Jobs (`website_hr_recruitment`)
expected_employee	Expected Employee	`integer`	computed added by Recruitment (`hr_recruitment`)
expenses_to_approve_count	Expenses to Approve	`integer`	computed added by Expenses (`hr_expense`)
has_read_access	Has Read Access	`boolean`
jobs_ids	Jobs	`one2many` → hr.job	inverse: `department_id`
leave_to_approve_count	Time Off to Approve	`integer`	computed added by Time Off (`hr_holidays`)
manager_id	Manager	`many2one` → hr.employee
master_department_id	Master Department	`many2one` → hr.department	computed, stored
member_ids	Members	`one2many` → hr.employee	read-only inverse: `department_id`
name	Department Name	`char`	requiredtranslatable
new_applicant_count	New Applicant	`integer`	computed added by Recruitment (`hr_recruitment`)
new_hired_employee	New Hired Employee	`integer`	computed added by Recruitment (`hr_recruitment`)
note	Note	`text`
parent_id	Parent Department	`many2one` → hr.department
parent_path	Parent Path	`char`
plan_ids	Plan	`one2many` → mail.activity.plan	inverse: `department_id`
plans_count	Plans Count	`integer`	computed
total_employee	Total Employee	`integer`	computed
activity_calendar_event_id	Next Activity Calendar Event	`many2one` → calendar.event	computed inherited from mail.activity.mixin
activity_date_deadline	Next Activity Deadline	`date`	read-onlycomputed inherited from mail.activity.mixin
activity_exception_decoration	Activity Exception Decoration Type of the exception activity on record.	`selection`	computed Values: `warning` (Alert), `danger` (Error) inherited from mail.activity.mixin
activity_exception_icon	Icon Icon to indicate an exception activity.	`char`	computed inherited from mail.activity.mixin
activity_ids	Activities	`one2many` → mail.activity	inverse: `res_id` inherited from mail.activity.mixin
activity_state	Activity State Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	computed Values: `overdue` (Overdue), `today` (Today), `planned` (Planned) inherited from mail.activity.mixin
activity_summary	Next Activity Summary	`char`	related: `activity_ids.summary` inherited from mail.activity.mixin
activity_type_icon	Activity Type Icon	`char`	related: `activity_ids.icon` inherited from mail.activity.mixin
activity_type_id	Next Activity Type	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` inherited from mail.activity.mixin
activity_user_id	Responsible User	`many2one` → res.users	read-onlycomputed inherited from mail.activity.mixin
has_message	Has Message	`boolean`	computed inherited from mail.thread
message_attachment_count	Attachment Count	`integer`	computed inherited from mail.thread
message_follower_ids	Followers	`one2many` → mail.followers	inverse: `res_id` inherited from mail.thread
message_has_error	Message Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_has_error_counter	Number of errors Number of messages with delivery error	`integer`	computed inherited from mail.thread
message_has_sms_error	SMS Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_ids	Messages	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
message_is_follower	Is Follower	`boolean`	computed inherited from mail.thread
message_needaction	Action Needed If checked, new messages require your attention.	`boolean`	computed inherited from mail.thread
message_needaction_counter	Number of Actions Number of messages requiring action	`integer`	computed inherited from mail.thread
message_partner_ids	Followers (Partners)	`many2many` → res.partner	computed inherited from mail.thread
my_activity_date_deadline	My Activity Deadline	`date`	read-onlycomputed inherited from mail.activity.mixin
rating_ids	Ratings	`one2many` → rating.rating	inverse: `res_id` inherited from mail.thread
website_message_ids	Website Messages Website communication history	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

hr.department: child_ids, master_department_id, parent_id
hr.employee: manager_id, member_ids
hr.job: jobs_ids
mail.activity.plan: plan_ids
res.company: company_id

Fields of other models pointing here

account.analytic.line: department_id
discuss.channel: subscription_department_ids
hr.applicant: department_id
hr.attendance: department_id
hr.department: master_department_id, parent_id
hr.employee.public: department_id
hr.expense: department_id
hr.job: department_id
hr.leave: department_id
hr.leave.allocation: department_id
hr.leave.allocation.generate.multi.wizard: department_id
hr.leave.attendance.report: department_id
hr.leave.employee.type.report: department_id
hr.leave.generate.multi.wizard: department_id
hr.leave.mandatory.day: department_ids
hr.leave.report: department_id
hr.leave.report.calendar: department_id
hr.resume.line: department_id
hr.version: department_id
hr.work.entry: department_id
mail.activity.plan: department_id
mail.activity.schedule: department_id
maintenance.equipment: department_id
resource.resource: department_id
timesheets.analysis.report: department_id

Reading this model through the API

Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/hr.department/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["complete_name","name","company_id","manager_id","master_department_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/hr.department/search_read",
    headers=headers,
    json={"domain": [], "fields": ["complete_name","name","company_id","manager_id","master_department_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/hr-department">hr.department (Odoo 19.0)</a>

Sources

Data verified on September 23, 2026 · Odoo 19.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.