Odoo 19.0 Community · Persistent

res.partner.bank: fields, relations and API

The res.partner.bank model ("Bank Accounts") is a persistent model declared by the Base module, then extended by 5 other modules. It exposes 76 fields, 46 of them declared directly on the model; 13 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.bank
Label: Bank Accounts
Type: Persistent (models.Model)
SQL table: res_partner_bank
Origin module: Base (base)
Extended by: account, account_qr_code_emv, base_iban, account_qr_code_sepa, hr
Default order (_order): sequence, id
Display field (_rec_name): acc_number
Inherits from (mixins): mail.thread mail.activity.mixin

Model fields

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

Hide inherited fields

76 of 76 fields shown

Technical name	Label	Type	Details
acc_holder_name	Account Holder Name Account holder name, in case it is different than the name of the Account Holder	`char`	computed, stored
acc_number	Account Number	`char`	required
acc_type	Type Bank account type: Normal or IBAN. Inferred from the bank account number.	`selection`	computed Values computed at runtime
active	Active	`boolean`
allow_out_payment	Send Money Sending fake invoices with a fraudulent account number is a common phishing practice. To protect yourself, always verify new bank account numbers, preferably by calling the vendor, as phishing usually happens when their emails are compromised. Once verified, you can activate the ability to send money.	`boolean`
bank_bic	Bank Bic	`char`	related: `bank_id.bic`
bank_city	Bank City	`char`	related: `bank_id.city` added by Employees (`hr`)
bank_country	Bank Country	`many2one` → res.country	related: `bank_id.country` added by Employees (`hr`)
bank_email	Bank Email	`char`	related: `bank_id.email` added by Employees (`hr`)
bank_id	Bank	`many2one` → res.bank
bank_name	Bank Name	`char`	related: `bank_id.name`
bank_phone	Bank Phone	`char`	related: `bank_id.phone` added by Employees (`hr`)
bank_state	Bank State	`many2one` → res.country.state	related: `bank_id.state` added by Employees (`hr`)
bank_street	Bank Street	`char`	related: `bank_id.street` added by Employees (`hr`)
bank_street2	Bank Street2	`char`	related: `bank_id.street2` added by Employees (`hr`)
bank_zip	Bank Zip	`char`	related: `bank_id.zip` added by Employees (`hr`)
clearing_number	Clearing Number	`char`
color	Color	`integer`	computed
company_id	Company	`many2one` → res.company	read-only related: `partner_id.company_id`
country_code	Country Code	`char`	related: `partner_id.country_code`
country_proxy_keys	Country Proxy Keys	`char`	computed added by account_qr_code_emv (`account_qr_code_emv`)
currency_id	Currency	`many2one` → res.currency
currency_symbol	Currency Symbol	`char`	related: `currency_id.symbol` added by Employees (`hr`)
display_qr_setting	Display Qr Setting	`boolean`	computed added by account_qr_code_emv (`account_qr_code_emv`)
duplicate_bank_partner_ids	Duplicate Bank Partner	`many2many` → res.partner	computed added by Invoicing (`account`)
employee_has_multiple_bank_accounts	Employee Has Multiple Bank Accounts	`boolean`	related: `employee_id.has_multiple_bank_accounts` added by Employees (`hr`)
employee_id	Employee	`many2many` → hr.employee	computed added by Employees (`hr`)
employee_salary_amount	Salary Allocation	`float`	read-onlycomputed added by Employees (`hr`)
employee_salary_amount_is_percentage	Employee Salary Amount Is Percentage	`boolean`	read-onlycomputed added by Employees (`hr`)
has_iban_warning	Has Iban Warning Technical field used to display a warning if the IBAN country is different than the holder country.	`boolean`	computed, stored added by Invoicing (`account`)
has_money_transfer_warning	Has Money Transfer Warning Technical field used to display a warning if the account is a transfer service account.	`boolean`	computed, stored added by Invoicing (`account`)
include_reference	Include Reference Include the reference in the QR code.	`boolean`	added by account_qr_code_emv (`account_qr_code_emv`)
journal_id	Account Journal The accounting journal corresponding to this bank account.	`one2many` → account.journal	read-only inverse: `bank_account_id` added by Invoicing (`account`)
lock_trust_fields	Lock Trust Fields	`boolean`	computed added by Invoicing (`account`)
money_transfer_service	Money Transfer Service	`char`	computed added by Invoicing (`account`)
note	Notes	`text`
partner_country_name	Partner Country Name	`char`	related: `partner_id.country_id.name` added by Invoicing (`account`)
partner_customer_rank	Partner Customer Rank	`integer`	related: `partner_id.customer_rank` added by Invoicing (`account`)
partner_id	Account Holder	`many2one` → res.partner	required
partner_supplier_rank	Partner Supplier Rank	`integer`	related: `partner_id.supplier_rank` added by Invoicing (`account`)
proxy_type	Proxy Type	`selection`	Values: `none` (None) added by account_qr_code_emv (`account_qr_code_emv`)
proxy_value	Proxy Value	`char`	added by account_qr_code_emv (`account_qr_code_emv`)
related_moves	Related Moves	`one2many` → account.move	inverse: `partner_bank_id` added by Invoicing (`account`)
sanitized_acc_number	Sanitized Account Number	`char`	read-onlycomputed, stored
sequence	Sequence	`integer`
user_has_group_validate_bank_account	User Has Group Validate Bank Account	`boolean`	computed added by Invoicing (`account`)
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_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
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` → 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
rating_ids	Ratings	`one2many` → rating.rating	inverse: `res_id` inherited from mail.thread
website_message_ids	Website Messages Website communication history	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
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.journal: journal_id
account.move: related_moves
hr.employee: employee_id
res.bank: bank_id
res.company: company_id
res.country: bank_country
res.country.state: bank_state
res.currency: currency_id
res.partner: duplicate_bank_partner_ids, partner_id

Fields of other models pointing here

account.journal: bank_account_id
account.move: partner_bank_id
account.payment: available_partner_bank_ids, partner_bank_id
account.payment.register: available_partner_bank_ids, partner_bank_id, untrusted_bank_ids
account.setup.bank.manual.config: res_partner_bank_id
hr.bank.account.allocation.wizard.line: bank_account_id
hr.employee: bank_account_ids, primary_bank_account_id
res.users: bank_account_ids, employee_bank_account_ids

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.bank/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["acc_number","partner_id","bank_country","bank_id","bank_state"],"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.bank/search_read",
    headers=headers,
    json={"domain": [], "fields": ["acc_number","partner_id","bank_country","bank_id","bank_state"], "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-bank">res.partner.bank (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.