maintenance.request: fields, relations and API
The maintenance.request model ("Maintenance Request") is a persistent model declared by the Maintenance module, then extended by 1 other module. It exposes 61 fields, 30 of them declared directly on the model. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.
Model identity
- Technical name
maintenance.request- Label
- Maintenance Request
- Type
- Persistent (models.Model)
- SQL table
maintenance_request- Origin module
- Maintenance (
maintenance) - Extended by
- hr_maintenance
- Default order (_order)
id desc- Inherits from (mixins)
- mail.thread.ccmail.activity.mixin
Model fields
30 own fields, 25 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
61 of 61 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| archive | Archive Set archive to true to hide the maintenance request without deleting it. | boolean | |
| category_id | Category | many2one | read-only related: |
| close_date | Close Date Date the maintenance was finished. | date | |
| color | Color Index | integer | |
| company_id | Company | many2one | required |
| description | Description | html | |
| done | Done | boolean | related: |
| duration | Duration Duration in hours. | float | computed, stored |
| employee_id | Employee | many2one | added by Maintenance - HR ( |
| equipment_id | Equipment | many2one | |
| instruction_google_slide | Google Slide Paste the url of your Google Slide. Make sure the access to the document is public. | char | |
| instruction_pdf | binary | ||
| instruction_text | Text | html | |
| instruction_type | Instruction | selection | Values: |
| kanban_state | Kanban State | selection | required Values: |
| maintenance_team_id | Team | many2one | requiredcomputed, stored |
| maintenance_type | Maintenance Type | selection | Values: |
| name | Subjects | char | required |
| owner_user_id | Created by User | many2one | computed, stored |
| priority | Priority | selection | Values: |
| recurring_maintenance | Recurrent | boolean | computed, stored |
| repeat_interval | Repeat Every | integer | |
| repeat_type | Until | selection | Values: |
| repeat_unit | Repeat Unit | selection | Values: |
| repeat_until | End Date | date | |
| request_date | Request Date Date requested for the maintenance to happen | date | |
| schedule_date | Scheduled Date Date the maintenance team plans the maintenance. It should not differ much from the Request Date. | datetime | |
| schedule_end | Scheduled End Expected completion date and time of the maintenance request. | datetime | computed, stored |
| stage_id | Stage | many2one | |
| user_id | Technician | many2one | computed, stored |
| activity_calendar_event_id | Next Activity Calendar Event | many2one | 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: 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 | inverse: 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: inherited from mail.activity.mixin |
| activity_summary | Next Activity Summary | char | related: inherited from mail.activity.mixin |
| activity_type_icon | Activity Type Icon | char | related: inherited from mail.activity.mixin |
| activity_type_id | Next Activity Type | many2one | related: inherited from mail.activity.mixin |
| activity_user_id | Responsible User | many2one | read-onlycomputed inherited from mail.activity.mixin |
| email_cc | Email cc | char | inherited from mail.thread.cc |
| 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 | inverse: 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 | inverse: 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 | computed inherited from mail.thread |
| my_activity_date_deadline | My Activity Deadline | date | read-onlycomputed inherited from mail.activity.mixin |
| rating_ids | Ratings | one2many | inverse: inherited from mail.thread |
| website_message_ids | Website Messages Website communication history | one2many | inverse: inherited from mail.thread |
| create_date | Created on | datetime | read-onlyautomatic |
| create_uid | Created by | many2one | 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 | read-onlyautomatic |
Relations
Models linked from this model
- hr.employee: employee_id
- maintenance.equipment: equipment_id
- maintenance.equipment.category: category_id
- maintenance.stage: stage_id
- maintenance.team: maintenance_team_id
- res.company: company_id
- res.users: owner_user_id, user_id
Fields of other models pointing here
No Many2one or Many2many field of another model points to this model.
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 -X POST "https://your-instance.odoo.com/json/2/maintenance.request/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","kanban_state","maintenance_team_id","category_id"],"limit":5}'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}/maintenance.request/search_read",
headers=headers,
json={"domain": [], "fields": ["name","company_id","kanban_state","maintenance_team_id","category_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/maintenance-request">maintenance.request (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.