ir.access: fields, relations and API
The ir.access model ("Access") is a persistent model declared by the Base module, then extended by 2 other modules. It exposes 31 fields, 13 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 20 JSON-2 API call.
Model identity
- Technical name
ir.access- Label
- Access
- Type
- Persistent (models.Model)
- SQL table
ir_access- Origin module
- Base (
base) - Extended by
- mail, website
- Default order (_order)
model_id, group_id, id- Inherits from (mixins)
- mail.thread
Model fields
13 own fields, 12 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
31 of 31 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| active | Active Only active accesses are taken into account when checking access rights. | boolean | |
| domain | Domain The operations will only be allowed for records in this domain | char | |
| for_create | Create Whether this access record applies for operation 'create' | boolean | computed |
| for_read | Read Whether this access record applies for operation 'read' | boolean | computed |
| for_unlink | Delete Whether this access record applies for operation 'unlink' | boolean | computed |
| for_write | Update Whether this access record applies for operation 'write' | boolean | computed |
| group_id | Group | many2one | |
| is_standard | Is Standard Whether the access is defined by a module | boolean | computed |
| kind | Kind Whether this record adds (permission) or restricts (restriction) access to the given model | selection | computed Values: |
| model_id | Model | many2one→ ir.model | required |
| name | Name | char | required |
| note | Note | html | |
| operation | Operation Which operation(s) this access applies to, a subset of 'crud'. | selection | required Values computed at runtime |
| 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 |
| rating_ids | Ratings | 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
- ir.model: model_id
- res.groups: group_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 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 -X POST "https://your-instance.odoo.com/json/2/ir.access/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","model_id","operation","group_id","active"],"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}/ir.access/search_read",
headers=headers,
json={"domain": [], "fields": ["name","model_id","operation","group_id","active"], "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/ir-access">ir.access (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.