loyalteez_check_perk_eligibility
Determine whether a user can claim a specific perk by returning eligibility, balance check, cost, and missing amount.
Instructions
Check if user can claim a specific perk. Returns eligibility status, balance check, cost, and missing amount.
See also: loyalteez://docs/shared-services/perks-service
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"userIdentifier": "<userIdentifier>",
"platform": "<platform>",
"perkId": "<perkId>"
},
"name": "loyalteez_check_perk_eligibility"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| perkId | Yes | UUID of the perk to check | |
| brandId | No | Your brand wallet address. If not provided, uses LOYALTEEZ_BRAND_ID environment variable. | |
| platform | Yes | Platform: "discord" | "telegram" | "web" | etc. | |
| userIdentifier | Yes | User identifier (platform_userId@loyalteez.app or email) |