Get Triggers

Provides a list of all active triggers in your gamification system. Triggers are invisible badges used for backend logic, A/B testing, feature unlocking, and risk detection.

Endpoint

GET /v1/admin/triggers

Response

{
"code": 200,
"data": [
  {
    "uid": "7627f728877c46e196e0197f764811ec",
    "label": "Daily Login",
    "points": 0,
    "description": "Track the login activity of the players and grant random prizes.\r\nBig prizes near-guaranteed at 180th and 365th days.",
    "startDate": "2010-01-10T00:00:00",
    "endDate": "2040-12-31T00:00:00",
    "requiredBadgeUId": null,
    "imageName": "https://rapidmulestorage.blob.core.windows.net/images/e269ec9c-3034-4e24-ac10-2b30428d607f_calendar.png",
    "isActive": true,
    "randomizedPrize": true,
    "limited": true,
    "type": "Ranked"
  },
  {
    "uid": "547fe3535cb74d9e8018e65e10b7624e",
    "label": "Deposit Fail (weekly)",

Response Fields

Field	Type	Description
uid	string	Unique identifier for the trigger
label	string	Display name of the trigger
points	number	Points awarded when trigger is activated
description	string	Description of the trigger's purpose
startDate	string	ISO 8601 timestamp of when the trigger becomes active
endDate	string	ISO 8601 timestamp of when the trigger expires
requiredBadgeUId	string	UID of badge required before this trigger can activate
imageName	string	URL to the trigger's icon/image
isActive	boolean	Whether this trigger is currently active
randomizedPrize	boolean	Whether deliverables are randomized
limited	boolean	Whether this trigger has limited activations
type	string	Trigger type: OneTimeOnly, Repeatable, or Ranked

Request Example

curl -X GET https://api.rapidmule.com/v1/admin/triggers \
  -H "Authorization: Bearer YOUR_API_KEY"

Trigger Types

Type	Description
OneTimeOnly	Activates only once per player
Repeatable	Can activate multiple times
Ranked	Has multiple levels/ranks

Error Codes

Code	Description	Resolution
1001	Payload is null	Check request parameters
4001	Invalid AuthKey	Verify API key

Learn More

For a deeper understanding of Triggers, see Core Concepts - Badges & Triggers.