Odoo 19.0 Community · Persistent

res.currency: fields, relations and API

The res.currency model ("Currency") is a persistent model declared by the Base module, then extended by 4 other modules. It exposes 24 fields, 18 of them declared directly on the model; 118 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.currency
Label: Currency
Type: Persistent (models.Model)
SQL table: res_currency
Origin module: Base (base)
Extended by: product, account, spreadsheet, point_of_sale
Default order (_order): active desc, name
Inherits from (mixins): pos.load.mixin

Model fields

18 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

24 of 24 fields shown

Technical name	Label	Type	Details
active	Active	`boolean`
currency_subunit_label	Currency Subunit	`char`	translatable
currency_unit_label	Currency Unit	`char`	translatable
date	Date	`date`	computed
decimal_places	Decimal Places Decimal places taken into account for operations on amounts in this currency. It is determined by the rounding factor.	`integer`	computed, stored
display_rounding_warning	Display Rounding Warning The warning informs a rounding factor change might be dangerous on res.currency's form view.	`boolean`	computed added by Invoicing (`account`)
fiscal_country_codes	Fiscal Country Codes	`char`	added by Invoicing (`account`)
full_name	Name	`char`
inverse_rate	Inverse Rate The currency of rate 1 to the rate of the currency.	`float`	read-onlycomputed
is_current_company_currency	Is Current Company Currency	`boolean`	computed
iso_numeric	Currency numeric code. Currency Numeric Code (ISO 4217).	`integer`
name	Currency Currency Code (ISO 4217)	`char`	required
position	Symbol Position Determines where the currency symbol should be placed after or before the amount.	`selection`	Values: `after` (After Amount), `before` (Before Amount)
rate	Current Rate The rate of the currency to the currency of rate 1.	`float`	computed
rate_ids	Rates	`one2many` → res.currency.rate	inverse: `currency_id`
rate_string	Rate String	`char`	computed
rounding	Rounding Factor Amounts in this currency are rounded off to the nearest multiple of the rounding factor.	`float`
symbol	Symbol Currency sign, to be used when printing amounts.	`char`	required
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.currency.rate: rate_ids

Fields of other models pointing here

account.account: company_currency_id, currency_id
account.accrued.orders.wizard: currency_id
account.analytic.account: currency_id
account.analytic.line: currency_id
account.automatic.entry.wizard: company_currency_id
account.bank.statement: currency_id
account.bank.statement.line: currency_id, foreign_currency_id
account.invoice.report: company_currency_id, currency_id
account.journal: currency_id
account.move: company_currency_id, currency_id
account.move.line: company_currency_id, currency_id
account.move.reversal: currency_id
account.partial.reconcile: company_currency_id, credit_currency_id, debit_currency_id
account.payment: company_currency_id, currency_id
account.payment.register: company_currency_id, currency_id, custom_user_currency_id, source_currency_id
account.payment.term: currency_id
account.sale.closing: currency_id
choose.delivery.carrier: currency_id
crm.lead: company_currency
crm.team: currency_id
delivery.carrier: currency_id
digest.digest: currency_id
event.booth.category: currency_id
event.event: currency_id
event.type.booth: currency_id
event.type.ticket: currency_id
fleet.vehicle: currency_id
fleet.vehicle.log.contract: currency_id
fleet.vehicle.log.services: currency_id
hr.employee: currency_id
hr.expense: company_currency_id, currency_id
hr.expense.split: currency_id
hr.expense.split.wizard: currency_id
hr.version: currency_id
loyalty.card: currency_id
loyalty.program: currency_id
loyalty.reward: currency_id
loyalty.rule: currency_id
lunch.cashmove: currency_id
lunch.cashmove.report: currency_id
and 59 more

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