Odoo 20.0 Community · Persistent

res.partner: fields, relations and API

The res.partner model ("Contact") is a persistent model declared by the Base module, then extended by 59 other modules. It exposes 269 fields, 213 of them declared directly on the model; 236 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: res.partner
Label: Contact
Type: Persistent (models.Model)
SQL table: res_partner
Origin module: Base (base)
Extended by: web, bus, mail, product, auth_signup, base_address_extended, portal, account, account_edi_ubl_cii, fleet, payment, account_peppol, phone_validation, base_geolocalize, calendar, contacts, crm, im_livechat, sale, project, delivery, event, google_address_autocomplete, hr, hr_calendar, hr_holidays, hr_recruitment, survey, website, website_partner, website_slides, l10n_fr, l10n_fr_account, l10n_fr_pdp, point_of_sale, loyalty, mass_mailing, mass_mailing_sms, stock, stock_delivery, purchase, purchase_stock, repair, mrp_subcontracting, partner_autocomplete, partnership, pos_sale, pos_hr, pos_self_order, privacy_lookup, sale_gelato, snailmail, snailmail_account, website_sale, website_blog, website_crm_partner_assign, website_customer, website_sale_stock, website_sale_gelato
Default order (_order): complete_name ASC, id DESC
Inherits from (mixins): format.address.mixin format.vat.label.mixin avatar.mixin properties.base.definition.mixin bus.listener.mixin mail.thread.blacklist mail.activity.mixin mail.thread.phonewebsite.published.multi.mixinwebsite.seo.metadata website.structured_data.mixin pos.load.mixin

Model fields

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

Hide inherited fields

269 of 269 fields shown

Technical name	Label	Type	Details
account_move_count	Account Move Count	`integer`	computed added by Invoicing (`account`)
activation	Activation	`many2one` → res.partner.activation	added by Resellers (`website_crm_partner_assign`)
active	Active	`boolean`
active_lang_count	Active Lang Count	`integer`	computed
additional_identifiers	Additional Identifiers	`json`
address	Address (without name)	`char`	computed
address_inline	Address inline (without name)	`char`	computed
applicant_ids	Applicants	`one2many` → hr.applicant	inverse: `partner_id` added by Recruitment (`hr_recruitment`)
application_statistics	Stats	`json`	computed
assigned_partner_id	Implemented by	`many2one` → res.partner	added by Resellers (`website_crm_partner_assign`)
autopost_bills	Auto-post bills Automatically post bills for this trusted partner	`selection`	required Values: `always` (Always), `ask` (Ask after 3 validations without edits), `never` (Never) added by Invoicing (`account`)
available_additional_identifiers_metadata	Available Additional Identifiers Metadata	`json`	computed
available_invoice_template_pdf_report_ids	Available Invoice Template Pdf Report	`one2many` → ir.actions.report	computed added by Invoicing (`account`)
available_peppol_edi_formats	Available Peppol Edi Formats	`json`	computed added by Peppol (`account_peppol`)
available_peppol_sending_methods	Available Peppol Sending Methods	`json`	computed added by Peppol (`account_peppol`)
available_routing_schemes	Available Routing Schemes	`json`	computed added by Import/Export electronic invoices with UBL/CII (`account_edi_ubl_cii`)
bank_account_count	Bank	`integer`	computed added by Invoicing (`account`)
bank_ids	Banks	`one2many` → res.partner.bank	inverse: `partner_id`
barcode	Barcode Use a barcode to identify this contact.	`char`	company-dependent
blog_post_ids	Blog Posts	`one2many` → blog.post	inverse: `author_id` added by Blog (`website_blog`)
bom_ids	BoMs for which the Partner is one of the subcontractors	`many2many` → mrp.bom	computed added by MRP Subcontracting (`mrp_subcontracting`)
buyer_id	Buyer	`many2one` → res.users	added by Purchase (`purchase`)
calendar_last_notif_ack	Last notification marked as read from base Calendar	`datetime`	added by Calendar (`calendar`)
category_id	Tags	`many2many` → res.partner.category
certifications_company_count	Company Certifications Count	`integer`	computed added by Surveys (`survey`)
certifications_count	Certifications Count	`integer`	computed added by Surveys (`survey`)
channel_ids	Channels	`many2many` → discuss.channel	added by Discuss (`mail`)
channel_member_ids	Channel Member	`one2many` → discuss.channel.member	inverse: `partner_id` added by Discuss (`mail`)
chatbot_script_ids	Chatbot Script	`one2many` → chatbot.script	inverse: `operator_partner_id` added by Live Chat (`im_livechat`)
child_ids	Related Contacts	`one2many` → res.partner	inverse: `parent_id`
city	City	`char`
city_id	City ID	`many2one` → res.city	added by Extended Addresses (`base_address_extended`)
color	Color Index	`integer`
comment	Notes	`html`
commercial_company_name	Company Name Entity	`char`	related: `commercial_partner_id.name`
commercial_partner_id	Commercial Entity	`many2one` → res.partner	computed, stored
company_id	Company	`many2one` → res.company
complete_name	Complete Name	`char`	computed, stored
contact_address	Complete Address	`char`	computed
contact_address_inline	Complete Address inline	`char`	computed
contract_ids	Partner Contracts	`one2many` → account.analytic.account	read-only inverse: `partner_id` added by Invoicing (`account`)
country_code	Country Code	`char`	related: `country_id.code`
country_enforce_cities	Country Enforce Cities	`boolean`	related: `country_id.enforce_cities` added by Extended Addresses (`base_address_extended`)
country_id	Country	`many2one` → res.country
credit	Total Receivable Total amount this customer owes you.	`monetary`	computed added by Invoicing (`account`)
credit_limit	Credit Limit Credit limit specific to this partner.	`float`	company-dependent added by Invoicing (`account`)
credit_to_invoice	Credit To Invoice	`monetary`	computed added by Invoicing (`account`)
currency_id	Currency	`many2one` → res.currency	read-onlycomputed added by Invoicing (`account`)
customer_rank	Customer Rank	`integer`	added by Invoicing (`account`)
date_localization	Geolocation Updated On	`date`	added by Partners Geolocation (`base_geolocalize`)
date_partnership	Partnership Date	`date`	added by Resellers (`website_crm_partner_assign`)
date_review	Latest Review	`date`	added by Resellers (`website_crm_partner_assign`)
date_review_next	Next Review	`date`	added by Resellers (`website_crm_partner_assign`)
days_sales_outstanding	Days Sales Outstanding (DSO) [(Total Receivable/Total Revenue) * number of days since the first invoice] for this customer	`float`	computed added by Invoicing (`account`)
debit	Total Payable Total amount you have to pay to this vendor.	`monetary`	computed added by Invoicing (`account`)
display_invoice_edi_format	Display Invoice Edi Format	`boolean`	added by Invoicing (`account`)
display_invoice_template_pdf_report_id	Display Invoice Template Pdf Report	`boolean`	computed added by Invoicing (`account`)
duplicate_bank_partner_ids	Duplicate Bank Partner	`many2many` → res.partner	computed added by Invoicing (`account`)
email	Email	`char`
email_formatted	Formatted Email Format email address "Name <email@domain>"	`char`	computed
employee	Employee Whether this contact is an Employee.	`boolean`	computed, stored
employee_ids	Employees Related employees based on their private address	`one2many` → hr.employee	inverse: `work_contact_id` added by Employees (`hr`)
employees_count	Employees Count	`integer`	computed added by Employees (`hr`)
event_count	# Events	`integer`	computed added by Events Organization (`event`)
fiscal_country_codes	Fiscal Country Codes	`char`	computed added by Invoicing (`account`)
fiscal_country_group_codes	Fiscal Country Group Codes	`json`	computed added by Invoicing (`account`)
fiscal_position_id	Automatic Fiscal Position Fiscal positions are used to adapt taxes and accounts for particular customers or sales orders/invoices. The default value comes from the customer.	`many2one` → account.fiscal.position	computed added by Point of Sale (`point_of_sale`)
function	Job Position	`char`
global_location_number	GLN Global Location Number	`char`	computed added by Invoicing (`account`)
grade_id	Partner Level	`many2one` → res.partner.grade	added by Partnership / Membership (`partnership`)
grade_sequence	Grade Sequence	`integer`	read-only related: `grade_id.sequence` added by Resellers (`website_crm_partner_assign`)
group_on	Week Day	`selection`	required Values: `default` (Expected Date), `1` (Monday), `2` (Tuesday), `3` (Wednesday), `4` (Thursday), `5` (Friday), `6` (Saturday), `7` (Sunday) added by Purchase Stock (`purchase_stock`)
group_rfq	Group RFQ Define if RFQ should be grouped together based on expected arrival, except for dropship operations. On Order: Replenishment needs will be grouped together except for MTO. Daily: Replenishment needs will be grouped if the expected arrival is the same day Weekly: Replenishment needs will be grouped if the expected arrival is the same week or week day Always: Replenishment needs will always be grouped.	`selection`	required Values: `default` (On Order), `day` (Daily), `week` (Weekly), `all` (Always) added by Purchase Stock (`purchase_stock`)
has_vat	Has Tax ID Technical field indicating whether the Tax ID is not a placeholder.Returns False for placeholder values such as '/', 'NA', 'na', or an empty string.	`boolean`	computed
ignore_abnormal_invoice_amount	Ignore Abnormal Invoice Amount	`boolean`	company-dependent added by Invoicing (`account`)
ignore_abnormal_invoice_date	Ignore Abnormal Invoice Date	`boolean`	company-dependent added by Invoicing (`account`)
implemented_partner_count	Implemented Partner Count	`integer`	computed, stored added by Resellers (`website_crm_partner_assign`)
implemented_partner_ids	Implementation References	`one2many` → res.partner	inverse: `assigned_partner_id` added by Resellers (`website_crm_partner_assign`)
incoterm_id	Incoterm International Commercial Terms are a series of predefined commercial terms used in international transactions.	`many2one` → account.incoterms	added by Sales (`sale`)
incoterm_location	Incoterm Location	`char`	added by Sales (`sale`)
industry_id	Industry	`many2one` → res.partner.industry
invoice_edi_format	eInvoice format	`selection`	computed added by Invoicing (`account`)
invoice_edi_format_store	Invoice Edi Format Store	`char`	company-dependent added by Invoicing (`account`)
invoice_emails	Invoice Emails	`char`	read-onlycomputed added by Point of Sale (`point_of_sale`)
invoice_ids	Invoices	`one2many` → account.move	read-only inverse: `partner_id` added by Invoicing (`account`)
invoice_sending_method	Invoice sending	`selection`	company-dependent Values: `manual` (Manual), `email` (by Email) added by Invoicing (`account`)
invoice_template_pdf_report_id	Invoice report	`many2one` → ir.actions.report	added by Invoicing (`account`)
is_company	Is a Company Check if the contact is a company, otherwise it is a person	`boolean`	computed, stored
is_in_call	Is In Call	`boolean`	computed added by Discuss (`mail`)
is_pricelist_manually_set	Is Pricelist Manually Set	`boolean`	computed added by Products & Pricelists (`product`)
is_public	Is Public	`boolean`	computed
is_published	Is Published	`boolean`	added by Website Partner (`website_partner`)
is_subcontractor	Subcontractor	`boolean`	computed added by MRP Subcontracting (`mrp_subcontracting`)
is_ubl_format	Is Ubl Format	`boolean`	computed added by Import/Export electronic invoices with UBL/CII (`account_edi_ubl_cii`)
l10n_fr_is_french	L10N Fr Is French	`boolean`	computed added by France - Localizations (`l10n_fr`)
l10n_fr_is_pdp	L10N Fr Is Pdp	`boolean`	computed added by France - E-Invoicing (Approved Platform) (`l10n_fr_pdp`)
l10n_fr_siren	L10N Fr Siren	`char`	computed added by France - Accounting (`l10n_fr_account`)
l10n_fr_siret	L10N Fr Siret	`char`	computed added by France - Accounting (`l10n_fr_account`)
lang	Language All the emails and documents sent to this contact will be translated in this language.	`selection`	computed, stored Values computed at runtime
leave_date_to	Leave Date To	`date`	computed added by Time Off (`hr_holidays`)
livechat_channel_count	Livechat Channel Count	`integer`	computed added by Live Chat (`im_livechat`)
loyalty_card_count	Active loyalty cards	`integer`	computed added by Coupons & Loyalty (`loyalty`)
mailing_contact_id	Contact	`many2one` → mailing.contact	computed added by Email Marketing (`mass_mailing`)
mailing_contact_ids	Contacts	`one2many` → mailing.contact	inverse: `partner_id` added by Email Marketing (`mass_mailing`)
main_user_id	Main User There can be several users related to the same partner. When a single user is needed, this field attempts to find the most appropriate one.	`many2one` → res.users	computed
meeting_count	# Meetings	`integer`	computed added by Calendar (`calendar`)
meeting_display_label	Meeting Display Label	`char`	computed added by Calendar (`calendar`)
meeting_ids	Meetings	`many2many` → calendar.event	added by Calendar (`calendar`)
meeting_next_date	Next Meeting	`date`	computed added by Calendar (`calendar`)
name	Name	`char`
on_time_rate	On-Time Delivery Rate Over the past x days; the number of products received on time divided by the number of ordered products.x is either the System Parameter purchase_stock.on_time_delivery_days or the default 365	`float`	computed added by Purchase Stock (`purchase_stock`)
opportunity_count	Opportunity Count	`integer`	computed added by CRM (`crm`)
opportunity_ids	Opportunities	`one2many` → crm.lead	inverse: `partner_id` added by CRM (`crm`)
parent_id	Related Company	`many2one` → res.partner
parent_name	Parent name	`char`	read-only related: `parent_id.name`
partner_cars_count	Cars Count	`integer`	computed added by Fleet (`fleet`)
partner_latitude	Latitude	`float`
partner_longitude	Longitude	`float`
partner_share	Share Partner Either customer (not a user), either shared user. Indicated the current partner is a customer without access or with a limited access created for sharing data.	`boolean`	computed, stored
partner_vat_placeholder	Partner Vat Placeholder	`char`	computed added by Invoicing (`account`)
partner_weight	Level Weight This should be a numerical value greater than 0 which will decide the contention for this partner to take this lead/opportunity.	`integer`	computed, stored added by Resellers (`website_crm_partner_assign`)
payment_token_count	Payment Token Count	`integer`	computed added by Payment Engine (`payment`)
payment_token_ids	Payment Tokens	`one2many` → payment.token	inverse: `partner_id` added by Payment Engine (`payment`)
pdp_verification_display_state	E-Invoicing State	`selection`	computed Values: `not_verified` (Not verified yet), `pdp_not_valid` (Partner is not in the annuaire), `pdp_not_valid_format` (Partner cannot receive format), `pdp_valid` (Partner is in the annuaire), `peppol_not_valid` (Partner is not on Peppol), `peppol_not_valid_format` (Partner cannot receive format), `peppol_valid` (Partner is on Peppol) added by France - E-Invoicing (Approved Platform) (`l10n_fr_pdp`)
peppol_response_support	Peppol Response Service	`boolean`	computed added by Peppol (`account_peppol`)
peppol_supported_documents	Supported Peppol Documents	`json`	added by Peppol (`account_peppol`)
peppol_verification_state	Peppol status	`selection`	company-dependent Values: `not_verified` (Unchecked), `not_valid` (Partner is not on Peppol), `not_valid_format` (Partner cannot receive format), `valid` (Partner is on Peppol) added by Peppol (`account_peppol`)
phone	Phone	`char`
picking_ids	Stock Pickings for which the Partner is the subcontractor	`many2many` → stock.picking	computed added by MRP Subcontracting (`mrp_subcontracting`)
picking_warn_msg	Message for Stock Picking	`text`	added by Inventory (`stock`)
pickup_delivery_method_id	Pickup Delivery Method The delivery method that generated this pickup point.	`many2one` → delivery.carrier	added by Product Availability (`website_sale_stock`)
pickup_location_data	Pickup Location Data Technical field: information needed by delivery providers in case of pickup point addresses.	`json`	added by Delivery - Stock (`stock_delivery`)
pos_order_count	Pos Order Count The number of point of sales orders related to this customer	`integer`	computed added by Point of Sale (`point_of_sale`)
pos_order_ids	Pos Order	`one2many` → pos.order	read-only inverse: `partner_id` added by Point of Sale (`point_of_sale`)
production_ids	MRP Productions for which the Partner is the subcontractor	`many2many` → mrp.production	computed added by MRP Subcontracting (`mrp_subcontracting`)
project_ids	Projects	`one2many` → project.project	inverse: `partner_id` added by Project (`project`)
property_account_payable_active	Account Payable Active	`boolean`	related: `property_account_payable_id.active` added by Invoicing (`account`)
property_account_payable_id	Account Payable	`many2one` → account.account	company-dependent added by Invoicing (`account`)
property_account_position_id	Fiscal Position The fiscal position determines the taxes/accounts used for this contact.	`many2one` → account.fiscal.position	company-dependent added by Invoicing (`account`)
property_account_receivable_active	Account Receivable Active	`boolean`	related: `property_account_receivable_id.active` added by Invoicing (`account`)
property_account_receivable_id	Account Receivable	`many2one` → account.account	company-dependent added by Invoicing (`account`)
property_delivery_carrier_id	Delivery Method Used in sales orders.	`many2one` → delivery.carrier	company-dependent added by Delivery Costs (`delivery`)
property_inbound_payment_method_line_id	Property Inbound Payment Method Line	`many2one` → account.payment.method.line	company-dependent added by Invoicing (`account`)
property_outbound_payment_method_line_id	Property Outbound Payment Method Line	`many2one` → account.payment.method.line	company-dependent added by Invoicing (`account`)
property_payment_term_id	Customer Payment Terms	`many2one` → account.payment.term	company-dependent added by Invoicing (`account`)
property_product_pricelist	Pricelist Used for sales to the current partner	`many2one` → product.pricelist	computed added by Products & Pricelists (`product`)
property_purchase_currency_id	Supplier Currency This currency will be used for purchases from the current partner	`many2one` → res.currency	company-dependent added by Purchase (`purchase`)
property_stock_customer	Customer Location The stock location used as destination when sending goods to this contact.	`many2one` → stock.location	company-dependent added by Inventory (`stock`)
property_stock_subcontractor	Subcontractor Location The stock location used as source and destination when sending goods to this contact during a subcontracting process.	`many2one` → stock.location	company-dependent added by MRP Subcontracting (`mrp_subcontracting`)
property_stock_supplier	Vendor Location The stock location used as source when receiving goods from this contact.	`many2one` → stock.location	company-dependent added by Inventory (`stock`)
property_supplier_payment_term_id	Vendor Payment Terms	`many2one` → account.payment.term	company-dependent added by Invoicing (`account`)
purchase_incoterm_id	Vendor Incoterm International Commercial Terms are a series of predefined commercial terms used in international transactions.	`many2one` → account.incoterms	added by Purchase (`purchase`)
purchase_incoterm_location	Vendor Incoterm Location	`char`	added by Purchase (`purchase`)
purchase_line_ids	Purchase Lines	`one2many` → purchase.order.line	inverse: `partner_id` added by Purchase Stock (`purchase_stock`)
purchase_order_count	Purchase Order Count	`integer`	computed added by Purchase (`purchase`)
purchase_warn_msg	Message for Purchase Order	`text`	added by Purchase (`purchase`)
qr_code_method	Payment QR-code	`selection`	company-dependent Values computed at runtime added by Invoicing (`account`)
receipt_reminder_email	Receipt Reminder Automatically send a confirmation email to the vendor X days before the expected receipt date, asking him to confirm the exact date.	`boolean`	company-dependent added by Purchase (`purchase`)
ref	Reference	`char`
ref_company_ids	Companies that refers to partner	`one2many` → res.company	inverse: `partner_id` added by Invoicing (`account`)
reminder_date_before_receipt	Days Before Receipt Number of days to send reminder email before the promised receipt date	`integer`	company-dependent added by Purchase (`purchase`)
repair_order_count	Repair Order Count	`integer`	computed added by Repairs (`repair`)
routing_endpoint	Routing Endpoint	`char`	computed, stored added by Import/Export electronic invoices with UBL/CII (`account_edi_ubl_cii`)
routing_identifier	EDI Routing Address	`char`	computed added by Import/Export electronic invoices with UBL/CII (`account_edi_ubl_cii`)
routing_scheme	Routing ID	`selection`	computed, stored Values: `9923` (Albania VAT), `9922` (Andorra VAT), `0151` (Australia ABN), `9914` (Austria UID), `9915` (Austria VOKZ), `0208` (Belgian Company Registry), `9925` (Belgian VAT), `9924` (Bosnia and Herzegovina VAT), `9926` (Bulgaria VAT), `9934` (Croatia VAT), `9928` (Cyprus VAT), `9929` (Czech Republic VAT)… added by Import/Export electronic invoices with UBL/CII (`account_edi_ubl_cii`)
rtc_session_ids	Rtc Session	`one2many` → discuss.channel.rtc.session	inverse: `partner_id` added by Discuss (`mail`)
sale_order_count	Sale Order Count	`integer`	computed added by Sales (`sale`)
sale_order_ids	Sales Order	`one2many` → sale.order	inverse: `partner_id` added by Sales (`sale`)
sale_warn_msg	Message for Sales Order	`text`	added by Sales (`sale`)
same_vat_partner_id	Partner with same Tax ID	`many2one` → res.partner	computed
self	Self	`many2one` → res.partner	computed
should_be_geolocalized	Should Be Geolocalized Indicates whether the partner's address has changed, so we should geolocalize them from their new address.	`boolean`	computed, stored added by Partners Geolocation (`base_geolocalize`)
show_credit_limit	Show Credit Limit	`boolean`	computed added by Invoicing (`account`)
signup_type	Signup Token Type	`char`	added by Signup (`auth_signup`)
slide_channel_company_count	Company Course Count	`integer`	computed added by eLearning (`website_slides`)
slide_channel_completed_ids	Completed Courses	`one2many` → slide.channel	computed added by eLearning (`website_slides`)
slide_channel_count	Course Count	`integer`	computed added by eLearning (`website_slides`)
slide_channel_ids	eLearning Courses	`many2many` → slide.channel	computed added by eLearning (`website_slides`)
specific_property_product_pricelist	Assigned Pricelist	`many2one` → product.pricelist	company-dependent added by Products & Pricelists (`product`)
state_id	State	`many2one` → res.country.state
static_map_url	Static Map Url	`char`	computed added by Events Organization (`event`)
static_map_url_is_valid	Static Map Url Is Valid	`boolean`	computed added by Events Organization (`event`)
street	Street	`char`
street_name	Street Name	`char`	computed, stored added by Extended Addresses (`base_address_extended`)
street_number	House	`char`	computed, stored added by Extended Addresses (`base_address_extended`)
street_number2	Door	`char`	computed, stored added by Extended Addresses (`base_address_extended`)
street2	Street2	`char`
suggest_based_on	Suggest Based On	`char`	added by Purchase Stock (`purchase_stock`)
suggest_days	Suggest Days	`integer`	added by Purchase Stock (`purchase_stock`)
suggest_percent	Suggest Percent	`integer`	added by Purchase Stock (`purchase_stock`)
supplier_invoice_count	# Vendor Bills	`integer`	computed added by Invoicing (`account`)
supplier_rank	Supplier Rank	`integer`	added by Invoicing (`account`)
task_count	# Tasks	`integer`	computed added by Project (`project`)
task_ids	Tasks	`one2many` → project.task	inverse: `partner_id` added by Project (`project`)
total_invoiced	Total Invoiced	`monetary`	computed added by Invoicing (`account`)
trust	Degree of trust you have in this debtor	`selection`	company-dependent Values: `good` (Good Debtor), `normal` (Normal Debtor), `bad` (Bad Debtor) added by Invoicing (`account`)
type	Address Type	`selection`	Values: `contact` (Contact), `invoice` (Invoice), `delivery` (Delivery), `other` (Other)
type_address_label	Address Type Description	`char`	computed
tz	Timezone When printing documents and exporting/importing data, time values are computed according to this timezone. If the timezone is not set, UTC (Coordinated Universal Time) is used. Anywhere else, time values are computed according to the time offset of your web client.	`selection`	Values computed at runtime
tz_offset	Timezone offset	`char`	computed
use_partner_credit_limit	Partner Limit Set a value greater than 0.0 to activate a credit limit check	`boolean`	computed added by Invoicing (`account`)
user_id	Salesperson The internal user in charge of this contact.	`many2one` → res.users	computed, stored
user_ids	Users	`one2many` → res.users	inverse: `partner_id`
user_livechat_username	User Livechat Username	`char`	computed added by Live Chat (`im_livechat`)
vat	Tax ID You can use '/' to indicate that the customer has no Tax ID.	`char`
vat_label	Tax ID Label	`char`	computed
visitor_ids	Visitors	`one2many` → website.visitor	inverse: `partner_id` added by Website (`website`)
website	Website Link	`char`
website_description	Website Partner Full Description	`html`	added by Website Partner (`website_partner`)
website_short_description	Website Partner Short Description	`text`	translatable added by Website Partner (`website_partner`)
website_tag_ids	Website tags Filter published customers on the .../customers website page	`many2many` → res.partner.tag	added by Customer References (`website_customer`)
wishlist_ids	Wishlist	`one2many` → product.wishlist	inverse: `partner_id` added by eCommerce (`website_sale`)
zip	Zip	`char`
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
avatar_1024	Avatar 1024	`image`	computed inherited from avatar.mixin
avatar_128	Avatar 128	`image`	computed inherited from avatar.mixin
avatar_1920	Avatar	`image`	computed inherited from avatar.mixin
avatar_256	Avatar 256	`image`	computed inherited from avatar.mixin
avatar_512	Avatar 512	`image`	computed inherited from avatar.mixin
email_normalized	Normalized Email This field is used to search on email address as the primary email field can contain more than strictly an email address.	`char`	computed, stored inherited from mail.thread.blacklist
has_message	Has Message	`boolean`	computed inherited from mail.thread
image_1024	Image 1024	`image`	related: `image_1920` inherited from image.mixin
image_128	Image 128	`image`	related: `image_1920` inherited from image.mixin
image_1920	Image	`image`	inherited from image.mixin
image_256	Image 256	`image`	related: `image_1920` inherited from image.mixin
image_512	Image 512	`image`	related: `image_1920` inherited from image.mixin
is_blacklisted	Blacklist If the email address is on the blacklist, the contact won't receive mass mailing anymore, from any list	`boolean`	computed inherited from mail.thread.blacklist
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_bounce	Bounce Counter of the number of bounced emails for this contact	`integer`	inherited from mail.thread.blacklist
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
phone_blacklisted	Blacklisted Phone is Phone Indicates if a blacklisted sanitized phone number is a phone number. Helps distinguish which number is blacklisted when there is both a mobile and phone field in a model.	`boolean`	computed inherited from mail.thread.phone
phone_formatted	Formatted Number	`char`	computed inherited from mail.thread.phone
phone_mobile_search	Phone Number	`char`	inherited from mail.thread.phone
phone_sanitized	Sanitized Number Field used to store sanitized phone number. Helps speeding up searches and comparisons.	`char`	computed, stored inherited from mail.thread.phone
phone_sanitized_blacklisted	Phone Blacklisted If the sanitized phone number is on the blacklist, the contact won't receive mass mailing sms anymore, from any list	`boolean`	computed inherited from mail.thread.phone
properties	Properties	`properties`	inherited from properties.base.definition.mixin
properties_base_definition_id	Properties Base Definition	`many2one` → properties.base.definition	computed inherited from properties.base.definition.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

account.account: property_account_payable_id, property_account_receivable_id
account.analytic.account: contract_ids
account.fiscal.position: fiscal_position_id, property_account_position_id
account.incoterms: incoterm_id, purchase_incoterm_id
account.move: invoice_ids
account.payment.method.line: property_inbound_payment_method_line_id, property_outbound_payment_method_line_id
account.payment.term: property_payment_term_id, property_supplier_payment_term_id
blog.post: blog_post_ids
calendar.event: meeting_ids
chatbot.script: chatbot_script_ids
crm.lead: opportunity_ids
delivery.carrier: pickup_delivery_method_id, property_delivery_carrier_id
discuss.channel: channel_ids
discuss.channel.member: channel_member_ids
discuss.channel.rtc.session: rtc_session_ids
hr.applicant: applicant_ids
hr.employee: employee_ids
ir.actions.report: available_invoice_template_pdf_report_ids, invoice_template_pdf_report_id
mailing.contact: mailing_contact_id, mailing_contact_ids
mrp.bom: bom_ids
mrp.production: production_ids
payment.token: payment_token_ids
pos.order: pos_order_ids
product.pricelist: property_product_pricelist, specific_property_product_pricelist
product.wishlist: wishlist_ids
project.project: project_ids
project.task: task_ids
purchase.order.line: purchase_line_ids
res.city: city_id
res.company: company_id, ref_company_ids
res.country: country_id
res.country.state: state_id
res.currency: currency_id, property_purchase_currency_id
res.partner: assigned_partner_id, child_ids, commercial_partner_id, duplicate_bank_partner_ids, implemented_partner_ids, parent_id, same_vat_partner_id, self
res.partner.activation: activation
res.partner.bank: bank_ids
res.partner.category: category_id
res.partner.grade: grade_id
res.partner.industry: industry_id
res.partner.tag: website_tag_ids
res.users: buyer_id, main_user_id, user_id, user_ids
sale.order: sale_order_ids
slide.channel: slide_channel_completed_ids, slide_channel_ids
stock.location: property_stock_customer, property_stock_subcontractor, property_stock_supplier
stock.picking: picking_ids
website.visitor: visitor_ids

Fields of other models pointing here

account.analytic.account: partner_id
account.analytic.distribution.model: partner_id
account.analytic.line: commercial_partner_id, message_partner_ids, partner_id
account.autopost.bills.wizard: partner_id
account.bank.statement.line: partner_id
account.invoice.report: commercial_partner_id, partner_id
account.journal: company_partner_id
account.move: bank_partner_id, commercial_partner_id, partner_id, partner_shipping_id
account.move.line: partner_id
account.move.send.wizard: mail_partner_ids
account.payment: commercial_partner_id, partner_id
account.payment.register: missing_account_partners, partner_id
account.reconcile.model: mapped_partner_id, match_partner_ids
account.reconcile.model.line: partner_id
base.document.layout: partner_id
base.partner.merge.automatic.wizard: dst_partner_id, partner_ids
bill.to.po.wizard: partner_id
blog.post: author_id
calendar.attendee: partner_id
calendar.event: invalid_email_partner_ids, partner_id, partner_ids, unavailable_partner_ids
calendar.event.archive.or.unlink.wizard: recipient_ids
calendar.filters: partner_id
chatbot.script: operator_partner_id
choose.delivery.carrier: partner_id, partner_shipping_id
crm.activity.report: author_id, partner_id
crm.lead: partner_assigned_id, partner_declined_ids, partner_id
crm.lead.assignation: partner_assigned_id
crm.lead.forward.to.partner: partner_id
crm.partner.report.assign: partner_id
crm.quotation.partner: partner_id
customer.product.reference: partner_id
delivery.note.wizard: partner_id
discuss.channel: channel_partner_ids, livechat_agent_partner_ids, livechat_bot_partner_ids, livechat_customer_partner_ids
discuss.channel.member: partner_id
discuss.channel.rtc.session: partner_id
event.booth: partner_id
event.booth.registration: partner_id
event.event: address_id, address_search, organizer_id
event.registration: event_organizer_id, partner_id
event.registration.answer: partner_id
and 124 more

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/res.partner/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","autopost_bills","group_on","group_rfq","activation"],"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/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","autopost_bills","group_on","group_rfq","activation"], "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">res.partner (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.