Odoo 19.0 Community · Persistent

res.partner.category: fields, relations and API

The res.partner.category model ("Partner Tags") is a persistent model declared by the Base module. It exposes 13 fields, 7 of them declared directly on the model; 5 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 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: res.partner.category
Label: Partner Tags
Type: Persistent (models.Model)
SQL table: res_partner_category
Origin module: Base (base)
Default order (_order): name, id

Model fields

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

Hide inherited fields

13 of 13 fields shown

Technical name	Label	Type	Details
active	Active The active field allows you to hide the category without removing it.	`boolean`
child_ids	Child Tags	`one2many` → res.partner.category	inverse: `parent_id`
color	Color	`integer`
name	Name	`char`	requiredtranslatable
parent_id	Category	`many2one` → res.partner.category
parent_path	Parent Path	`char`
partner_ids	Partners	`many2many` → res.partner
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

res.partner: partner_ids
res.partner.category: child_ids, parent_id

Fields of other models pointing here

account.analytic.distribution.model: partner_category_id
loyalty.generate.wizard: customer_tag_ids
mailing.contact: tag_ids
res.partner: category_id
res.partner.category: parent_id

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

curl -X POST "https://your-instance.odoo.com/json/2/res.partner.category/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","parent_id","active","color","parent_path"],"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}/res.partner.category/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","parent_id","active","color","parent_path"], "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-partner-category">res.partner.category (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.