API reference

Challenges Class

The Challenges API enhances social interactions in your app, which use com.meta.horizon.platform.ovr.requests.GroupPresence#setDestination(String apiName) to create shareable links for score-based competition. Players can repeatedly challenge others, get to know them, and compete asynchronously. Challenges can be ranked by highest/lowest scores within a time period. Leaderboard-integrated apps get Challenges for free, accessible through the Scoreboards UI. Players can create and invite others to Challenges via the Challenges app.

Static Methods

create ( leaderboardName , challengeOptions )
DeprecatedUse server-to-server API call instead.
Signature 
static Request<com.meta.horizon.platform.ovr.models.Challenge> com.meta.horizon.platform.ovr.requests.Challenges.create(String leaderboardName, ChallengeOptions challengeOptions)
Parameters
leaderboardName: String  - A string represents the name of the leaderboard.
challengeOptions: ChallengeOptions  - This indicates the options of the challenge and it can be retrieved by com.meta.horizon.platform.ovr.options.ChallengeOptions#ChallengeOptions().
Returns
Request< com.meta.horizon.platform.ovr.models.Challenge >
declineInvite ( challengeID )
If the current user has the necessary permissions, they can decline a challenge by providing the challenge ID, which can be obtained using com.meta.horizon.platform.ovr.models.Challenge#getID().
Signature 
static Request<com.meta.horizon.platform.ovr.models.Challenge> com.meta.horizon.platform.ovr.requests.Challenges.declineInvite(long challengeID)
Parameters
challengeID: long  - The ID of challenge that the user is going to decline. It can be retrieved by com.meta.horizon.platform.ovr.models.Challenge#getID().
Returns
Request< com.meta.horizon.platform.ovr.models.Challenge >
delete ( challengeID )
DeprecatedUse server-to-server API call instead.
Signature 
static Request com.meta.horizon.platform.ovr.requests.Challenges.delete(long challengeID)
Parameters
challengeID: long  - The uuid of the challenge.
Returns
Request
get ( challengeID )
Gets detailed information for a single challenge by providing the challenge ID, which can be retrieved by calling com.meta.horizon.platform.ovr.models.Challenge#getID().
Signature 
static Request<com.meta.horizon.platform.ovr.models.Challenge> com.meta.horizon.platform.ovr.requests.Challenges.get(long challengeID)
Parameters
challengeID: long  - The id of the challenge whose entries to return, which can be retrieved by calling com.meta.horizon.platform.ovr.models.Challenge#getID().
Returns
Request< com.meta.horizon.platform.ovr.models.Challenge >
getEntries ( challengeID , limit , filter , startAt )
Retrieves a list of entries for a specific challenge, with options to filter and limit the results. By providing the challengeID, you can specify which challenge's entries you want to retrieve. The limit parameter allows you to control the number of entries returned. The filter parameter enables you to refine the results to only include entries from users who are bidirectional followers. The startAt parameter allows you to define whether to center the query on the user or start at the top of the challenge.
Signature 
static Request<com.meta.horizon.platform.ovr.models.ChallengeEntryArray> com.meta.horizon.platform.ovr.requests.Challenges.getEntries(long challengeID, int limit, LeaderboardFilterType filter, LeaderboardStartAt startAt)
Parameters
challengeID: long  - The id of the challenge whose entries to return, which can be retrieved by calling com.meta.horizon.platform.ovr.models.Challenge#getID().
limit: int  - Sets a limit on the maximum number of challenges to be fetched, which can be useful for pagination or performance reasons.
filter: LeaderboardFilterType  - By using the LeaderboardFilterType, you can refine the results to only include entries from users who are bidirectional followers.
startAt: LeaderboardStartAt  - Defines whether to center the query on the user or start at the top of the challenge. If this is com.meta.horizon.platform.ovr.enums.LeaderboardStartAt#CenteredOnViewer or com.meta.horizon.platform.ovr.enums.LeaderboardStartAt#CenteredOnViewerOrTop, then the current user's ID will be automatically added to the query.
Returns
Request< com.meta.horizon.platform.ovr.models.ChallengeEntryArray >
getEntriesAfterRank ( challengeID , limit , afterRank )
Returns a list of entries for a specific challenge, starting from a specified rank. By providing the challengeID and rank, you can specify which challenge's entries you want to retrieve and where to start the query. The limit parameter allows you to control the number of entries returned.
Signature 
static Request<com.meta.horizon.platform.ovr.models.ChallengeEntryArray> com.meta.horizon.platform.ovr.requests.Challenges.getEntriesAfterRank(long challengeID, int limit, long afterRank)
Parameters
challengeID: long  - The id of the challenge whose entries to return, which can be retrieved by calling com.meta.horizon.platform.ovr.models.Challenge#getID().
limit: int  - Sets a limit on the maximum number of challenges to be fetched, which can be useful for pagination or performance reasons.
afterRank: long  - The position after which to start. For example, 10 returns challenge results starting with the 11th user.
Returns
Request< com.meta.horizon.platform.ovr.models.ChallengeEntryArray >
getEntriesByIds ( challengeID , limit , startAt , userIDs )
Retrieves a list of challenge entries for a specific set of user IDs, with options to filter and limit the results. This method is useful for retrieving a list of challenge entries for a specific set of users, allowing you to display their progress and rankings within the challenge.
Signature 
static Request<com.meta.horizon.platform.ovr.models.ChallengeEntryArray> com.meta.horizon.platform.ovr.requests.Challenges.getEntriesByIds(long challengeID, int limit, LeaderboardStartAt startAt, long[] userIDs)
Parameters
challengeID: long  - The id of the challenge whose entries to return, which can be retrieved by calling com.meta.horizon.platform.ovr.models.Challenge#getID().
limit: int  - Sets a limit on the maximum number of challenges to be fetched, which can be useful for pagination or performance reasons.
startAt: LeaderboardStartAt  - Defines whether to center the query on the user or start at the top of the challenge. If this is com.meta.horizon.platform.ovr.enums.LeaderboardStartAt#CenteredOnViewer or com.meta.horizon.platform.ovr.enums.LeaderboardStartAt#CenteredOnViewerOrTop, then the current user's ID will be automatically added to the query.
userIDs: long []  - Defines a list of user ids to get entries for.
Returns
Request< com.meta.horizon.platform.ovr.models.ChallengeEntryArray >
getList ( challengeOptions , limit )
Returns a list of challenges that match the specified options. The com.meta.horizon.platform.ovr.options.ChallengeOptions#ChallengeOptions() parameter allows you to specify the criteria for the challenges you want to retrieve. The limit parameter allows you to control the number of challenges returned.
Signature 
static Request<com.meta.horizon.platform.ovr.models.ChallengeArray> com.meta.horizon.platform.ovr.requests.Challenges.getList(ChallengeOptions challengeOptions, int limit)
Parameters
challengeOptions: ChallengeOptions  - This indicates the options of the challenge and it can be retrieved by com.meta.horizon.platform.ovr.options.ChallengeOptions#ChallengeOptions().
limit: int  - Sets a limit on the maximum number of challenges to be fetched, which can be useful for pagination or performance reasons.
Returns
Request< com.meta.horizon.platform.ovr.models.ChallengeArray >
join ( challengeID )
If the current user has the necessary permissions to join, participate in a challenge by providing the challenge ID, which can be retrieved using com.meta.horizon.platform.ovr.models.Challenge#getID().
Signature 
static Request<com.meta.horizon.platform.ovr.models.Challenge> com.meta.horizon.platform.ovr.requests.Challenges.join(long challengeID)
Parameters
challengeID: long  - The ID of challenge that the user is going to join. It can be retrieved by com.meta.horizon.platform.ovr.models.Challenge#getID().
Returns
Request< com.meta.horizon.platform.ovr.models.Challenge >
leave ( challengeID )
If the current user has the necessary permissions, they can leave a challenge by providing the challenge ID, which can be obtained using com.meta.horizon.platform.ovr.models.Challenge#getID().
Signature 
static Request<com.meta.horizon.platform.ovr.models.Challenge> com.meta.horizon.platform.ovr.requests.Challenges.leave(long challengeID)
Parameters
challengeID: long  - The ID of challenge that the user is going to leave. It can be retrieved by com.meta.horizon.platform.ovr.models.Challenge#getID().
Returns
Request< com.meta.horizon.platform.ovr.models.Challenge >
updateInfo ( challengeID , challengeOptions )
DeprecatedUse server-to-server API call instead.
Signature 
static Request<com.meta.horizon.platform.ovr.models.Challenge> com.meta.horizon.platform.ovr.requests.Challenges.updateInfo(long challengeID, ChallengeOptions challengeOptions)
Parameters
challengeID: long  - The uuid of the challenge.
challengeOptions: ChallengeOptions  - This indicates the options of the challenge and it can be retrieved by com.meta.horizon.platform.ovr.options.ChallengeOptions#ChallengeOptions().
Returns
Request< com.meta.horizon.platform.ovr.models.Challenge >
Meta
English (US)
© 2026 Meta