Skip to main content
GET
/
leaderboards
/
configs
Get paginated leaderboard configurations
curl --request GET \
  --url https://{subdomain}.nudj.cx/api/v2/integration/leaderboards/configs \
  --header 'x-api-token: <api-key>'
{
  "totalCount": 123,
  "edges": [
    {
      "name": "<string>",
      "metricType": "total-xp",
      "startsAt": "<string>",
      "status": "archived",
      "period": "daily",
      "conditions": [],
      "id": "<string>",
      "organisationId": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "reward": [
        {
          "startRank": 123,
          "endRank": 123,
          "points": 1,
          "completionXp": 1,
          "items": [
            {
              "id": "<string>",
              "organisationId": "<string>",
              "communityId": "<string>",
              "additionalCommunityIds": [
                "<string>"
              ],
              "details": {
                "title": "<string>",
                "description": "<string>",
                "light": {
                  "primaryImageUrl": "<string>",
                  "secondaryImageUrl": "<string>"
                },
                "dark": {
                  "primaryImageUrl": "<string>",
                  "secondaryImageUrl": "<string>"
                }
              },
              "assetPointsPrice": 1,
              "assetPointsSwapValue": 1,
              "entryPointsPrice": 1,
              "assetsSupply": 1,
              "entriesSupply": 1,
              "maxAssetsPerUser": 2,
              "maxEntriesPerUser": 2,
              "allocationsType": "assets-only",
              "isSharedAssetsSupply": true,
              "isSharedEntriesSupply": true,
              "allocations": [
                {
                  "id": "<string>",
                  "allocationType": "assets",
                  "supply": 1,
                  "amountToDistribute": 2,
                  "distributed": 1,
                  "isShop": true,
                  "isLive": true
                }
              ],
              "redemptionConfig": {
                "type": "rich-text",
                "additionalInformation": [
                  {
                    "variableConfigId": "<string>",
                    "required": true,
                    "position": 2
                  }
                ],
                "autoRedeem": false,
                "content": "<string>",
                "instructions": "<string>",
                "instructionsImageUrl": "<string>",
                "supportEmail": "[email protected]",
                "supportPhoneNumber": "<string>",
                "supportUrl": "<string>",
                "redeemByDate": "<string>"
              },
              "tags": [
                {
                  "id": "<string>",
                  "organisationId": "<string>",
                  "value": "<string>",
                  "config": {
                    "filtering": [
                      "achievement"
                    ],
                    "display": [
                      "achievement"
                    ],
                    "iconifyIcon": "<string>"
                  },
                  "createdAt": "<string>",
                  "updatedAt": "<string>"
                }
              ],
              "campaigns": [
                {
                  "id": "<string>",
                  "organisationId": "<string>",
                  "name": "<string>",
                  "startDate": "<string>",
                  "endDate": "<string>",
                  "status": "archived",
                  "createdAt": "<string>",
                  "updatedAt": "<string>"
                }
              ],
              "status": "archived",
              "isManualGiveaway": true,
              "availableAsTemplateForOrganisations": [
                "<string>"
              ],
              "isGlobalTemplate": true,
              "metadata": {},
              "createdAt": "<string>",
              "updatedAt": "<string>",
              "challenges": [
                {
                  "id": "<string>",
                  "organisationId": "<string>",
                  "communityId": "<string>",
                  "additionalCommunityIds": [
                    "<string>"
                  ],
                  "details": {
                    "title": "<string>",
                    "description": "<string>",
                    "light": {
                      "primaryImageUrl": "<string>",
                      "secondaryImageUrl": "<string>"
                    },
                    "dark": {
                      "primaryImageUrl": "<string>",
                      "secondaryImageUrl": "<string>"
                    }
                  },
                  "progressPeriod": "daily",
                  "maxCompletionsPerPeriod": 1,
                  "numberOfActions": 1,
                  "actionIds": [
                    "<string>"
                  ],
                  "actionGroups": [
                    {
                      "id": "<string>",
                      "type": "single",
                      "details": {
                        "title": "<string>",
                        "description": "<string>",
                        "light": {
                          "primaryImageUrl": "<string>",
                          "secondaryImageUrl": "<string>"
                        },
                        "dark": {
                          "primaryImageUrl": "<string>",
                          "secondaryImageUrl": "<string>"
                        }
                      },
                      "parentGroupId": "<string>",
                      "displayType": "list"
                    }
                  ],
                  "status": "archived",
                  "isLinear": true,
                  "unlockPrice": 1,
                  "tags": [
                    {
                      "id": "<string>",
                      "organisationId": "<string>",
                      "value": "<string>",
                      "config": {
                        "filtering": [
                          "achievement"
                        ],
                        "display": [
                          "achievement"
                        ],
                        "iconifyIcon": "<string>"
                      },
                      "createdAt": "<string>",
                      "updatedAt": "<string>"
                    }
                  ],
                  "campaigns": [
                    {
                      "id": "<string>",
                      "organisationId": "<string>",
                      "name": "<string>",
                      "startDate": "<string>",
                      "endDate": "<string>",
                      "status": "archived",
                      "createdAt": "<string>",
                      "updatedAt": "<string>"
                    }
                  ],
                  "availableAsTemplateForOrganisations": [
                    "<string>"
                  ],
                  "isGlobalTemplate": true,
                  "groupIds": [
                    "<string>"
                  ],
                  "createdAt": "<string>",
                  "videoConfig": {
                    "videoUrl": "<string>",
                    "isVideoEnabled": true
                  },
                  "actions": [
                    {
                      "id": "<string>",
                      "organisationId": "<string>",
                      "communityId": "<string>",
                      "allocationId": "<string>",
                      "allocatedTo": "achievement",
                      "position": 123,
                      "category": "nudj",
                      "key": "facebook-comment",
                      "details": {
                        "title": "<string>",
                        "description": "<string>",
                        "light": {
                          "primaryImageUrl": "<string>",
                          "secondaryImageUrl": "<string>"
                        },
                        "dark": {
                          "primaryImageUrl": "<string>",
                          "secondaryImageUrl": "<string>"
                        }
                      },
                      "progressPeriod": "daily",
                      "maxCompletionsPerPeriod": 1,
                      "attributes": {
                        "key": "question-multiple-choice",
                        "question": "<string>",
                        "options": [
                          {
                            "id": "<string>",
                            "label": "<string>"
                          }
                        ],
                        "minimumNumberOfAnswersRequired": 2,
                        "maximumNumberOfAnswersAllowed": 2
                      },
                      "config": {
                        "isOptional": true,
                        "socialValidation": "validation-on",
                        "prerequisites": {
                          "requiredActionCount": 123,
                          "actionIds": [
                            "<string>"
                          ]
                        },
                        "requiresCorrectAnswer": true
                      },
                      "videoMetadata": {
                        "startsAtMs": 1,
                        "shouldPause": true,
                        "validatesAtMs": 1,
                        "endsAtMs": 1
                      },
                      "createdAt": "<string>",
                      "stats": {
                        "totalXp": 123
                      },
                      "reward": {
                        "points": 1,
                        "completionXp": 1,
                        "items": [
                          {
                            "id": "<string>",
                            "details": {
                              "title": "<string>",
                              "description": "<string>",
                              "light": {
                                "primaryImageUrl": "<string>",
                                "secondaryImageUrl": "<string>"
                              },
                              "dark": {
                                "primaryImageUrl": "<string>",
                                "secondaryImageUrl": "<string>"
                              }
                            },
                            "type": "assets",
                            "amountToDistribute": 1,
                            "totalSupply": 1,
                            "remainingSupply": 1
                          }
                        ],
                        "rewardSelectionMethod": "all",
                        "numberOfRewardsToReceive": 1,
                        "distributionEventId": "<string>"
                      },
                      "userState": {
                        "status": "completed",
                        "criteriaMet": true,
                        "statusMessage": "<string>",
                        "eligibleXp": 123,
                        "earnedXp": 123,
                        "attempts": 123,
                        "output": {
                          "key": "interaction-external-link",
                          "eventId": "<string>"
                        },
                        "unmetCriteriaMessage": "<string>"
                      },
                      "participations": [
                        {
                          "id": "<string>",
                          "criteriaMet": true,
                          "output": {
                            "key": "interaction-external-link",
                            "eventId": "<string>"
                          },
                          "status": "pending",
                          "participatedAt": "<string>",
                          "processingStartedAt": "<string>",
                          "processedAt": "<string>",
                          "unmetCriteriaMessage": "<string>",
                          "processingFailedMessage": "<string>"
                        }
                      ],
                      "actionGroupId": "<string>",
                      "actionGroupIndex": 123,
                      "availableAsTemplateForOrganisations": [
                        "<string>"
                      ],
                      "isGlobalTemplate": true,
                      "previousAction": "<string>",
                      "nextAction": "<string>"
                    }
                  ],
                  "community": {
                    "id": "<string>",
                    "name": "<string>",
                    "description": "<string>",
                    "slug": "<string>",
                    "logo": "<string>"
                  },
                  "participantStats": {
                    "startedCount": 1,
                    "completedCount": 1
                  },
                  "stats": {
                    "totalXp": 1,
                    "totalActionsCount": 1
                  },
                  "reward": {
                    "points": 1,
                    "completionXp": 1,
                    "items": [
                      {
                        "id": "<string>",
                        "details": {
                          "title": "<string>",
                          "description": "<string>",
                          "light": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          },
                          "dark": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          }
                        },
                        "type": "assets",
                        "amountToDistribute": 1,
                        "totalSupply": 1,
                        "remainingSupply": 1
                      }
                    ],
                    "rewardSelectionMethod": "all",
                    "numberOfRewardsToReceive": 1,
                    "distributionEventId": "<string>"
                  },
                  "userState": {
                    "status": "completed",
                    "completionsInPeriod": 0,
                    "totalCompletions": 0,
                    "keysContributed": 0,
                    "latestAttempt": {
                      "eligibleXp": 0,
                      "actionsCompletedCount": 0,
                      "earnedXp": 0,
                      "earnedPoints": 0,
                      "earnedRewardAssets": [
                        {
                          "rewardAssetId": "<string>",
                          "rewardId": "<string>"
                        }
                      ],
                      "earnedRewardEntries": [
                        {
                          "rewardEntryId": "<string>",
                          "rewardId": "<string>",
                          "amount": 1
                        }
                      ],
                      "completionTime": 0,
                      "successRate": 0,
                      "startedAt": "<string>"
                    },
                    "historicAttempts": []
                  },
                  "challengeType": "survey",
                  "enabledForSingleView": true,
                  "startDate": "<string>",
                  "endDate": "<string>",
                  "featured": true,
                  "threadId": "<string>",
                  "isSkippable": true,
                  "startsAt": "<string>",
                  "expiresAt": "<string>",
                  "updatedAt": "<string>"
                }
              ],
              "achievements": [
                {
                  "id": "<string>",
                  "organisationId": "<string>",
                  "details": {
                    "title": "<string>",
                    "description": "<string>",
                    "light": {
                      "primaryImageUrl": "<string>",
                      "secondaryImageUrl": "<string>"
                    },
                    "dark": {
                      "primaryImageUrl": "<string>",
                      "secondaryImageUrl": "<string>"
                    }
                  },
                  "progressPeriod": "daily",
                  "displayMode": "default",
                  "tags": [
                    "<string>"
                  ],
                  "campaigns": [
                    "<string>"
                  ],
                  "criteria": {
                    "type": "sum",
                    "parameters": {
                      "query": "<string>",
                      "operator": "==",
                      "attribute": "<string>",
                      "value": 123
                    }
                  },
                  "queries": [
                    {
                      "type": "event",
                      "alias": "<string>",
                      "parameters": {
                        "eventName": "<string>",
                        "eventCategory": "achievement",
                        "eventSubCategory": "achievement-completion",
                        "eventSourceId": "<string>",
                        "tags": [
                          "<string>"
                        ]
                      },
                      "isCommunityScoped": true
                    }
                  ],
                  "queryDescriptions": {},
                  "status": "archived",
                  "availableAsTemplateForOrganisations": [
                    "<string>"
                  ],
                  "isGlobalTemplate": true,
                  "createdAt": "<string>",
                  "updatedAt": "<string>",
                  "userState": {
                    "status": "completed",
                    "timesCompleted": 1,
                    "isClaimable": true,
                    "isClaimed": true,
                    "updatedAt": "<string>",
                    "earnedPoints": 1,
                    "earnedRewardAssets": [
                      {
                        "id": "<string>",
                        "organisationId": "<string>",
                        "communityId": "<string>",
                        "rewardId": "<string>",
                        "allocationId": "<string>",
                        "userId": "<string>",
                        "details": {
                          "title": "<string>",
                          "description": "<string>",
                          "light": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          },
                          "dark": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          }
                        },
                        "redeemable": {
                          "type": "rich-text",
                          "additionalInformation": [
                            {
                              "variableConfigId": "<string>",
                              "required": true,
                              "position": 2
                            }
                          ],
                          "content": "<string>",
                          "instructions": "<string>",
                          "instructionsImageUrl": "<string>",
                          "supportEmail": "[email protected]",
                          "supportPhoneNumber": "<string>",
                          "supportUrl": "<string>",
                          "redeemByDate": "<string>"
                        },
                        "eventCategory": "achievement",
                        "eventSubCategory": "achievement-completion",
                        "tags": [
                          "<string>"
                        ],
                        "campaigns": [
                          "<string>"
                        ],
                        "metadata": {},
                        "createdAt": "<string>",
                        "updatedAt": "<string>",
                        "additionalCommunityIds": [
                          "<string>"
                        ],
                        "eventSourceId": "<string>",
                        "claimedAt": "<string>",
                        "redeemedAt": "<string>",
                        "expiresAt": "<string>"
                      }
                    ],
                    "earnedRewardEntries": [
                      {
                        "id": "<string>",
                        "organisationId": "<string>",
                        "communityId": "<string>",
                        "rewardId": "<string>",
                        "userId": "<string>",
                        "details": {
                          "title": "<string>",
                          "description": "<string>",
                          "light": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          },
                          "dark": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          }
                        },
                        "totalEntries": 123,
                        "entries": [
                          {
                            "allocationId": "<string>",
                            "amount": 123,
                            "createdAt": "<string>"
                          }
                        ],
                        "tags": [
                          "<string>"
                        ],
                        "campaigns": [
                          "<string>"
                        ],
                        "createdAt": "<string>",
                        "updatedAt": "<string>",
                        "additionalCommunityIds": [
                          "<string>"
                        ],
                        "status": "pending",
                        "rewardAssetIds": [
                          "<string>"
                        ],
                        "checkByDate": "<string>",
                        "checkedAt": "<string>",
                        "drawnAt": "<string>",
                        "rewardAssets": [
                          {
                            "id": "<string>",
                            "organisationId": "<string>",
                            "communityId": "<string>",
                            "rewardId": "<string>",
                            "allocationId": "<string>",
                            "userId": "<string>",
                            "details": {
                              "title": "<string>",
                              "description": "<string>",
                              "light": {
                                "primaryImageUrl": "<string>",
                                "secondaryImageUrl": "<string>"
                              },
                              "dark": {
                                "primaryImageUrl": "<string>",
                                "secondaryImageUrl": "<string>"
                              }
                            },
                            "redeemable": {
                              "type": "rich-text",
                              "additionalInformation": [
                                {
                                  "variableConfigId": "<string>",
                                  "required": true,
                                  "position": 2
                                }
                              ],
                              "content": "<string>",
                              "instructions": "<string>",
                              "instructionsImageUrl": "<string>",
                              "supportEmail": "[email protected]",
                              "supportPhoneNumber": "<string>",
                              "supportUrl": "<string>",
                              "redeemByDate": "<string>"
                            },
                            "eventCategory": "achievement",
                            "eventSubCategory": "achievement-completion",
                            "tags": [
                              "<string>"
                            ],
                            "campaigns": [
                              "<string>"
                            ],
                            "metadata": {},
                            "createdAt": "<string>",
                            "updatedAt": "<string>",
                            "additionalCommunityIds": [
                              "<string>"
                            ],
                            "eventSourceId": "<string>",
                            "claimedAt": "<string>",
                            "redeemedAt": "<string>",
                            "expiresAt": "<string>"
                          }
                        ]
                      }
                    ],
                    "earnedXp": 1,
                    "type": "sum",
                    "isComplete": true,
                    "currentValue": 123,
                    "targetValue": 123,
                    "conditions": "<array>",
                    "completedAt": "<string>",
                    "progressResetsAt": "<string>"
                  },
                  "stats": {
                    "completedCount": 1
                  },
                  "reward": {
                    "points": 1,
                    "completionXp": 1,
                    "items": [
                      {
                        "id": "<string>",
                        "details": {
                          "title": "<string>",
                          "description": "<string>",
                          "light": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          },
                          "dark": {
                            "primaryImageUrl": "<string>",
                            "secondaryImageUrl": "<string>"
                          }
                        },
                        "type": "assets",
                        "amountToDistribute": 1,
                        "totalSupply": 1,
                        "remainingSupply": 1
                      }
                    ],
                    "rewardSelectionMethod": "all",
                    "numberOfRewardsToReceive": 1,
                    "distributionEventId": "<string>"
                  },
                  "communityId": "<string>",
                  "featured": true,
                  "startsAt": "<string>",
                  "expiresAt": "<string>"
                }
              ],
              "initialAssetSupply": 1,
              "initialEntrySupply": 1,
              "distributedAssetCount": 1,
              "distributedEntryCount": 1,
              "remainingAssetSupply": 1,
              "remainingEntrySupply": 1,
              "remainingShopAssetSupply": 1,
              "remainingShopEntrySupply": 1,
              "userEntryCount": 0,
              "userAssetCount": 0,
              "featured": true,
              "drawsAt": "<string>",
              "startsAt": "<string>",
              "expiresAt": "<string>"
            }
          ],
          "rewardSelectionMethod": "all",
          "numberOfRewardsToReceive": 1
        }
      ],
      "description": "<string>",
      "expiresAt": "<string>"
    }
  ]
}

Authorizations

x-api-token
string
header
required

Headers

x-language
string

The language to return the leaderboards in. If not provided, the default language for the organisation will be used.

Query Parameters

limit
integer
default:10
Required range: 1 <= x <= 100
skip
integer
default:0
Required range: x >= 0
status
enum<string>
Available options:
archived,
draft,
expired,
live,
scheduled
communityId
string

Response

Successful response

totalCount
number
required
edges
object[]
required