res.session: fields, relations and API
The res.session model ("Session") is a persistent model declared by the Base module. It exposes 22 fields, 7 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
res.session- Label
- Session
- Type
- Persistent (models.Model)
- SQL table
- None (no table)
- Origin module
- Base (
base) - Default order (_order)
last_activity desc- Inherits from (mixins)
- res.device
Model fields
7 own fields, 9 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
22 of 22 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| city | City | char | read-onlycomputed |
| country | Country | char | read-onlycomputed |
| device_ids | Device | one2many | read-onlycomputed |
| first_activity | First Activity | datetime | read-onlycomputed |
| ip_address | IP Address | char | read-onlycomputed |
| is_current | Current | boolean | read-onlycomputed |
| user_agent | User Agent | char | read-onlycomputed |
| browser | Browser | char | read-onlycomputed inherited from res.device |
| browser_language | Browser Language | char | read-onlycomputed inherited from res.device |
| browser_version | Browser Version | char | read-onlycomputed inherited from res.device |
| device_type | Type | char | read-onlycomputed inherited from res.device |
| last_activity | Last Activity | datetime | read-only inherited from res.device |
| platform | Platform | char | read-onlycomputed inherited from res.device |
| revoked | Revoked | boolean | read-only inherited from res.device |
| session_identifier | Session identifier | char | read-only inherited from res.device |
| user_id | User | many2one | read-only inherited from res.device |
| 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
- res.device: device_ids
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/res.session/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["display_name"],"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}/res.session/search_read",
headers=headers,
json={"domain": [], "fields": ["display_name"], "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/res-session">res.session (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.