loyalteez_check_eligibility
Validate whether a user can receive a reward for a specific event before tracking it. Returns eligibility status, cooldown info, and claim history.
Instructions
Check if a user is eligible to receive a reward for a specific event. Returns eligibility status, cooldown info, and claim history. Use this BEFORE tracking an event to validate the user can receive the reward.
Implementation Note: Eligibility checking requires event configuration (maxClaims, cooldown, reward) and user claim history. If the endpoint is unavailable, eligibility can be determined by:
Calling
loyalteez_get_event_configto get event settingsChecking user's claim count against maxClaims
Verifying cooldown period has elapsed
See also: loyalteez://docs/api/rest-api
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": {
"eventType": "<eventType>",
"userEmail": "<userEmail>"
},
"name": "loyalteez_check_eligibility"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brandId | No | Your brand wallet address. If not provided, uses LOYALTEEZ_BRAND_ID environment variable. | |
| eventType | Yes | Event type to check eligibility for | |
| userEmail | Yes | User's email address |