Loyalty Levels Model

A loyalty level represents a progression tier with its own threshold, benefits, and accumulation behavior.

Core operations

Action	Method	Resource
List	GET	/loyalty_levels
Find	GET	/loyalty_levels/{loyalty_level_id}
Create	POST	/loyalty_levels
Update	POST	/loyalty_levels/{loyalty_level_id}
Delete	DELETE	/loyalty_levels/{loyalty_level_id}

The detail read and all mutations require administrator authentication.

Representative fields

Core fields include id, name, description, benefits, minimum_points, accumulation_rate, maximum_accumulation_percentage, maximum_accumulation_fixed, expire_after_minutes, image, created_at, and updated_at.

minimum_points marks the threshold for the level, while accumulation_rate and the maximum accumulation fields control earning behavior. The meaning of maximum accumulation may vary by operation; check the field description before using it.

See Create a loyalty level and List loyalty levels.

Schema properties

Schema: LoyaltyLevel

Name	Type	Description
accumulation_rate	number | null	—
benefits	object | array | null	—
created_at	string | null	—
description	any	—
expire_after_minutes	any	—
id	integer | null	—
image	any	—
maximum_accumulation_fixed	number | null	—
maximum_accumulation_percentage	number | null	—
minimum_points	integer | null	—
name	any	—
updated_at	string | null	—