Odoo 20.0 Community · Persistent

hr.leave: fields, relations and API

The hr.leave model ("Time Off") is a persistent model declared by the Time Off module, then extended by 3 other modules. It exposes 96 fields, 65 of them declared directly on the model; 8 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 20 JSON-2 API call.

View source code Search another model

Model identity

Technical name: hr.leave
Label: Time Off
Type: Persistent (models.Model)
SQL table: hr_leave
Origin module: Time Off (hr_holidays)
Extended by: hr_holidays_attendance, l10n_fr_hr_holidays, project_timesheet_holidays
Default order (_order): date_from desc
Inherits from (mixins): mail.thread.main.attachment mail.activity.mixin hr.leave.display.name.mixin hr.time.rule.source.mixin

Model fields

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

Hide inherited fields

96 of 96 fields shown

Technical name	Label	Type	Details
active_employee	Employee Active	`boolean`	related: `employee_id.active`
allocation_display_warning	Allocation Display Warning	`char`	computed
allowed_request_durations	Allowed Request Durations	`json`	computed
allowed_work_entry_type_ids	Allowed Work Entry Type	`many2many` → hr.work.entry.type	computed
attachment_ids	Attachments	`one2many` → ir.attachment	inverse: `res_id`
attachment_is_visible	Attachment Is Visible	`boolean`	computed
can_approve	Can Approve	`boolean`	computed
can_back_to_approve	Can Back To Approve	`boolean`	computed
can_cancel	Can Cancel	`boolean`	computed
can_refuse	Can Refuse	`boolean`	computed
can_reschedule	Can Reschedule	`boolean`	computed
can_validate	Can Validate	`boolean`	computed
color	Color	`integer`	related: `work_entry_type_id.color`
company_id	Company	`many2one` → res.company	computed, stored
count_as	Count As	`selection`	related: `work_entry_type_id.count_as`
dashboard_warning_message	Dashboard Warning Message	`char`	computed
date_from	Start Date	`datetime`	computed, stored
date_to	End Date	`datetime`	computed, stored
department_id	Department	`many2one` → hr.department	computed, stored
duration_display	Requested	`char`	computed
employee_company_id	Employee Company	`many2one` → res.company	related: `employee_id.company_id`
employee_id	Employee	`many2one` → hr.employee	required
first_approver_id	First Approval This area is automatically filled by the user who validate the time off	`many2one` → hr.employee	read-only
has_mandatory_day	Has Mandatory Day	`boolean`	computed
is_hatched	Hatched	`boolean`	computed
is_striked	Striked	`boolean`	computed
is_time_rule_trimmed	Trimmed by Time Rule Set when a time rule trims this leave's end to sub-day precision. Prevents _compute_date_from_to from snapping the end back to the schedule boundary.	`boolean`
l10n_fr_date_to_changed	L10N Fr Date To Changed	`boolean`	added by France - Time Off (`l10n_fr_hr_holidays`)
last_several_days	All day	`boolean`	computed
max_leaves	Max Leaves	`float`	computed
meeting_id	Meeting	`many2one` → calendar.event
name	Description	`char`	computed
notes	Reasons	`text`
number_of_days	Duration (Days) Number of days of the time off request. Used in the calculation.	`float`	computed, stored
number_of_hours	Duration (Hours) Number of hours of the time off request. Used in the calculation.	`float`	computed, stored
output_leave_ids	Output Leave	`one2many` → hr.leave	inverse: `source_leave_id`
private_name	Time Off Description	`char`
request_date_from	Request Start Date	`date`
request_date_from_period	Date Period Start	`selection`	Values: `am` (Morning), `pm` (Afternoon)
request_date_hour_from	Request Date Hour From	`datetime`	computed
request_date_hour_to	Request Date Hour To	`datetime`	computed
request_date_to	Request End Date	`date`
request_date_to_period	Date Period End	`selection`	Values: `am` (Morning), `pm` (Afternoon)
request_duration	Duration	`selection`	Values: `full` (Full Day), `am` (Morning), `pm` (Afternoon), `specific` (Specific)
request_hour_from	Hour from	`float`
request_hour_to	Hour to	`float`
resource_calendar_id	Resource Calendar	`many2one` → resource.calendar	computed, stored
second_approver_id	Second Approval This area is automatically filled by the user who validate the time off with second level (If time type need second validation)	`many2one` → hr.employee	read-only
source_leave_id	Source Leave	`many2one` → hr.leave
state	Status	`selection`	Values: `confirm` (To Approve), `refuse` (Refused), `validate1` (Second Approval), `validate` (Approved), `cancel` (Cancelled)
supported_attachment_ids	Attach File	`many2many` → ir.attachment	computed
supported_attachment_ids_count	Supported Attachment Ids Count	`integer`	computed
time_rule_id	Time Rule	`many2one` → hr.time.rule
time_rule_time_range	Time Rule Time Range HH:MM → HH:MM label shown on rule-split and trimmed leaves.	`char`	computed
timesheet_ids	Analytic Lines	`one2many` → account.analytic.line	inverse: `holiday_id` added by Timesheet when on Time Off (`project_timesheet_holidays`)
tz	Tz	`selection`	computed Values computed at runtime
tz_mismatch	Tz Mismatch	`boolean`	computed
user_id	User	`many2one` → res.users	read-only related: `employee_id.user_id`
validation_type	Validation Type	`selection`	related: `work_entry_type_id.leave_validation_type`
virtual_remaining_leaves	Available Time Off	`float`	computed
work_entry_type_id	Time Type	`many2one` → hr.work.entry.type	required
work_entry_type_increases_duration	Work Entry Type Increases Duration	`char`	computed
work_entry_type_request_unit	Work Entry Type Request Unit	`selection`	read-only related: `work_entry_type_id.request_unit`
work_entry_type_requires_allocation	Work Entry Type Requires Allocation	`boolean`	related: `work_entry_type_id.requires_allocation`
work_entry_type_support_document	Work Entry Type Support Document	`boolean`	related: `work_entry_type_id.support_document`
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_plans_ids	Activity Plans	`many2many` → mail.activity.plan	computed 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_main_attachment_id	Main Attachment	`many2one` → ir.attachment	inherited from mail.thread.main.attachment
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
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
display_name	Display Name	`char`	read-onlycomputedautomatic
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

account.analytic.line: timesheet_ids
calendar.event: meeting_id
hr.department: department_id
hr.employee: employee_id, first_approver_id, second_approver_id
hr.leave: output_leave_ids, source_leave_id
hr.time.rule: time_rule_id
hr.work.entry.type: allowed_work_entry_type_ids, work_entry_type_id
ir.attachment: attachment_ids, supported_attachment_ids
res.company: company_id, employee_company_id
res.users: user_id
resource.calendar: resource_calendar_id

Fields of other models pointing here

Reading this model through the API

Odoo 20 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.leave/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","employee_id","work_entry_type_id","state","company_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.leave/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","employee_id","work_entry_type_id","state","company_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-leave">hr.leave (Odoo 20.0)</a>

Sources

Data verified on September 25, 2026 · Odoo 20.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.