loyalty.card: fields, relations and API
The loyalty.card model ("Loyalty Coupon") is a persistent model declared by the Coupons & Loyalty module, then extended by 3 other modules. It exposes 36 fields, 17 of them declared directly on the model; 7 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.
Model identity
- Technical name
loyalty.card- Label
- Loyalty Coupon
- Type
- Persistent (models.Model)
- SQL table
loyalty_card- Origin module
- Coupons & Loyalty (
loyalty) - Extended by
- pos_loyalty, sale_loyalty, website_sale_loyalty
- Display field (_rec_name)
code- Inherits from (mixins)
- mail.threadpos.load.mixin
Model fields
17 own fields, 13 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
36 of 36 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| active | Active | boolean | |
| code | Code | char | required |
| company_id | Company | many2one | related: |
| currency_id | Currency | many2one | related: |
| expiration_date | Expiration Date | date | |
| history_ids | History | one2many | read-only inverse: |
| order_id | Order Reference The sales order from which coupon is generated | many2one | read-only added by Sale Loyalty ( |
| order_id_partner_id | Sale Order Customer | many2one | related: added by Sale Loyalty ( |
| partner_id | Partner | many2one | |
| point_name | Point Name | char | read-only related: |
| points | Points | float | |
| points_display | Points Display | char | computed |
| program_id | Program | many2one | |
| program_type | Program Type | selection | related: |
| source_pos_order_id | PoS Order Reference PoS order where this coupon was generated. | many2one | added by Point of Sale - Coupons & Loyalty ( |
| source_pos_order_partner_id | PoS Order Customer | many2one | related: added by Point of Sale - Coupons & Loyalty ( |
| use_count | Use Count | integer | computed |
| 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 | inverse: 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 | inverse: 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 | computed inherited from mail.thread |
| rating_ids | Ratings | one2many | inverse: inherited from mail.thread |
| website_message_ids | Website Messages Website communication history | one2many | inverse: inherited from mail.thread |
| 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
- loyalty.history: history_ids
- loyalty.program: program_id
- pos.order: source_pos_order_id
- res.company: company_id
- res.currency: currency_id
- res.partner: order_id_partner_id, partner_id, source_pos_order_partner_id
- sale.order: order_id
Fields of other models pointing here
- coupon.share: coupon_id
- loyalty.card.update.balance: card_id
- loyalty.history: card_id
- pos.order.line: coupon_id
- sale.order: applied_coupon_ids
- sale.order.coupon.points: coupon_id
- sale.order.line: coupon_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 -X POST "https://your-instance.odoo.com/json/2/loyalty.card/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["code","company_id","currency_id","order_id","order_id_partner_id"],"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}/loyalty.card/search_read",
headers=headers,
json={"domain": [], "fields": ["code","company_id","currency_id","order_id","order_id_partner_id"], "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/loyalty-card">loyalty.card (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.