Odoo 20.0 Community · Persistent

hr.job: fields, relations and API

The hr.job model ("Job Position") is a persistent model declared by the Employees module, then extended by 5 other modules. It exposes 97 fields, 56 of them declared directly on the model; 11 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.job
Label: Job Position
Type: Persistent (models.Model)
SQL table: hr_job
Origin module: Employees (hr)
Extended by: hr_recruitment, hr_skills, hr_recruitment_skills, hr_recruitment_survey, website_hr_recruitment
Default order (_order): sequence, name asc
Inherits from (mixins): mail.thread mail.alias.mixin mail.activity.mixin website.seo.metadatawebsite.published.multi.mixinwebsite.searchable.mixin website.structured_data.mixin

Model fields

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

Hide inherited fields

97 of 97 fields shown

Technical name	Label	Type	Details
active	Active	`boolean`
activity_count	Activity Count	`integer`	computed added by Recruitment (`hr_recruitment`)
address_id	Job Location Select the location where the applicant will work. Addresses listed here are defined on the company's contact information.	`many2one` → res.partner	added by Recruitment (`hr_recruitment`)
alias_id	Alias Email alias for this job position. New emails will automatically create new applicants for this job position.	`many2one` → mail.alias	added by Recruitment (`hr_recruitment`)
all_application_count	All Application Count	`integer`	computed added by Recruitment (`hr_recruitment`)
applicant_hired	Applicants Hired	`integer`	computed added by Recruitment (`hr_recruitment`)
applicant_matching_score	Matching Score(%)	`float`	computed added by Recruitment - Skills Management (`hr_recruitment_skills`)
application_count	Application Count	`integer`	computed added by Recruitment (`hr_recruitment`)
application_ids	Job Applications	`one2many` → hr.applicant	inverse: `job_id` added by Recruitment (`hr_recruitment`)
color	Color Index	`integer`	added by Recruitment (`hr_recruitment`)
company_country_code	Company Country Code	`char`	related: `company_id.country_id.code`
company_id	Company	`many2one` → res.company	required
company_partner_id	Company Partner	`many2one` → res.partner	computed added by Recruitment (`hr_recruitment`)
currency_id	Currency	`many2one` → res.currency	read-only related: `company_id.currency_id` added by Recruitment (`hr_recruitment`)
current_job_skill_ids	Current Job Skill	`one2many` → hr.job.skill	computed added by Skills Management (`hr_skills`)
department_id	Department	`many2one` → hr.department
description	Job Description	`html`
document_ids	Documents	`one2many` → ir.attachment	read-onlycomputed added by Recruitment (`hr_recruitment`)
documents_count	Document Count	`integer`	computed added by Recruitment (`hr_recruitment`)
employee_count	Employee Count	`integer`	computed added by Recruitment (`hr_recruitment`)
employee_ids	Employees	`one2many` → hr.employee	inverse: `job_id`
employee_type_id	Employee Type	`many2one` → hr.employee.type
expected_degree	Expected Degree	`many2one` → hr.recruitment.degree	added by Recruitment (`hr_recruitment`)
expected_employees	Total Forecasted Employees Expected number of employees for this job position after new recruitment.	`integer`	computed
extended_interviewer_ids	Extended Interviewer	`many2many` → res.users	computed, stored added by Recruitment (`hr_recruitment`)
favorite_recruiter_ids	Favorite Recruiter	`many2many` → hr.employee	added by Recruitment (`hr_recruitment`)
full_url	job URL	`char`	computed added by Online Jobs (`website_hr_recruitment`)
industry_id	Industry	`many2one` → res.partner.industry	added by Recruitment (`hr_recruitment`)
interviewer_ids	Interviewers The Interviewers set on the job position can see all Applicants in it. They have access to the information, the attachments, the meeting management and they can refuse him. You don't need to have Recruitment rights to be set as an interviewer.	`many2many` → res.users	added by Recruitment (`hr_recruitment`)
is_favorite	Is Favorite	`boolean`	computed added by Recruitment (`hr_recruitment`)
job_details	Process Details Complementary information that will appear on the job submission page	`html`	translatable added by Online Jobs (`website_hr_recruitment`)
job_properties	Properties	`properties`	added by Recruitment (`hr_recruitment`)
job_skill_ids	Skills	`one2many` → hr.job.skill	inverse: `job_id` added by Skills Management (`hr_skills`)
job_source_ids	Job Source	`one2many` → hr.recruitment.source	inverse: `job_id` added by Recruitment (`hr_recruitment`)
manager_id	Department Manager	`many2one` → hr.employee	read-only related: `department_id.manager_id` added by Recruitment (`hr_recruitment`)
matching_applicant_skill_ids	Matching Skills	`many2many` → hr.skill	computed added by Recruitment - Skills Management (`hr_recruitment_skills`)
missing_applicant_skill_ids	Missing Skills	`many2many` → hr.skill	computed added by Recruitment - Skills Management (`hr_recruitment_skills`)
name	Job Position	`char`	requiredtranslatable
new_application_count	New Application Number of applications that are new in the flow (typically at first step of the flow)	`integer`	computed added by Recruitment (`hr_recruitment`)
no_of_employee	Current Number of Employees Number of employees currently occupying this job position.	`integer`	computed
no_of_hired_employee	Hired Number of hired employees for this job position during recruitment phase.	`integer`	computed, stored added by Recruitment (`hr_recruitment`)
no_of_recruitment	Target Number of new employees you expect to recruit.	`integer`
old_application_count	Old Application	`integer`	computed added by Recruitment (`hr_recruitment`)
open_application_count	Open Application Count Number of applications that are still ongoing (not hired or refused)	`integer`	computed added by Recruitment (`hr_recruitment`)
payment_interval	Scheduled Pay	`selection`	required Values: `hourly` (Hour), `daily` (Day), `weekly` (Week), `biweekly` (Bi-Week), `monthly` (Month), `yearly` (Year) added by Recruitment (`hr_recruitment`)
recruiter_id	Recruiter The Recruiter will be the default value for all Applicants in this job position. The Recruiter is automatically added to all meetings with the Applicant.	`many2one` → hr.employee
requirements	Requirements	`text`
salary_max	Maximum Salary	`monetary`	added by Recruitment (`hr_recruitment`)
salary_min	Minimum Salary	`monetary`	added by Recruitment (`hr_recruitment`)
sequence	Sequence	`integer`
skill_ids	Skill	`many2many` → hr.skill	computed, stored added by Skills Management (`hr_skills`)
survey_id	Interview Form Choose an interview form for this job position and you will be able to print/answer this interview from all applicants who apply for this job	`many2one` → survey.survey	added by Hr Recruitment Interview Forms (`hr_recruitment_survey`)
tag_ids	Tags	`many2many` → hr.job.tag	added by Recruitment (`hr_recruitment`)
website_description	Website description	`html`	added by Online Jobs (`website_hr_recruitment`)
website_published	Website Published Set if the application is published on the website of the company.	`boolean`	added by Online Jobs (`website_hr_recruitment`)
website_rating	Website rating	`html`	added by Online Jobs (`website_hr_recruitment`)
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
alias_defaults	Alias Defaults	`text`	inherited from mail.alias.mixin
alias_domain	Alias Domain Name	`char`	related: `alias_id.alias_domain` inherited from mail.alias.mixin.optional
alias_domain_id	Alias Domain	`many2one` → mail.alias.domain	related: `alias_id.alias_domain_id` inherited from mail.alias.mixin.optional
alias_email	Email Alias	`char`	computed inherited from mail.alias.mixin.optional
alias_name	Alias Name	`char`	inherited from mail.alias.mixin
has_message	Has Message	`boolean`	computed inherited from mail.thread
is_seo_optimized	SEO optimized	`boolean`	computed, stored inherited from website.seo.metadata
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
seo_name	Seo name	`char`	translatable inherited from website.seo.metadata
website_meta_description	Website meta description	`text`	translatable inherited from website.seo.metadata
website_meta_keywords	Website meta keywords	`char`	translatable inherited from website.seo.metadata
website_meta_og_img	Website opengraph image	`char`	inherited from website.seo.metadata
website_meta_title	Website meta title	`char`	translatable inherited from website.seo.metadata
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

hr.applicant: application_ids
hr.department: department_id
hr.employee: employee_ids, favorite_recruiter_ids, manager_id, recruiter_id
hr.employee.type: employee_type_id
hr.job.skill: current_job_skill_ids, job_skill_ids
hr.job.tag: tag_ids
hr.recruitment.degree: expected_degree
hr.recruitment.source: job_source_ids
hr.skill: matching_applicant_skill_ids, missing_applicant_skill_ids, skill_ids
ir.attachment: document_ids
mail.alias: alias_id
res.company: company_id
res.currency: currency_id
res.partner: address_id, company_partner_id
res.partner.industry: industry_id
res.users: extended_interviewer_ids, interviewer_ids
survey.survey: survey_id

Fields of other models pointing here

hr.applicant: job_id
hr.employee.public: job_id
hr.expense.product.job.position.limit: job_ids
hr.job.skill: job_id
hr.leave.attendance.report: job_id
hr.leave.mandatory.day: job_ids
hr.leave.report.calendar: job_id
hr.recruitment.source: job_id
hr.recruitment.stage: job_ids
hr.version: job_id
job.add.applicants: job_ids

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.job/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","company_id","payment_interval","address_id","alias_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.job/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","company_id","payment_interval","address_id","alias_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-job">hr.job (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.