activities.list
Description
Returns an overview of all players currently online or in game.
Code Examples
Request
curl -X GET 'https://api.rivet.gg/identity/activities'
Request Parameters
watch_index
Query parameter, optional
Response Body
games
array<object>
(required)
games[*].banner_url
string
The URL of this game's banner image.
games[*].developer
object
(required)
A group handle.
games[*].developer.avatar_url
string
The URL of this group's avatar image
games[*].developer.display_name
string
(required)
games[*].developer.external
object
(required)
External links for this group.
games[*].developer.external.profile
string
(required)
A link to this group's profile page.
games[*].developer.group_id
string
(required)
games[*].developer.is_developer
boolean
Whether or not this group is a developer group.
games[*].display_name
string
(required)
games[*].game_id
string
(required)
games[*].logo_url
string
The URL of this game's logo image.
games[*].name_id
string
(required)
A human readable short identifier used to references resources. Different than a uuid
because this is intended to be human readable. Different than DisplayName
because this should not include special characters and be short.
games[*].total_player_count
integer
(required)
Unsigned 32 bit integer.
games[*].url
string
(required)
identities
array<object>
(required)
identities[*].account_number
integer
(required)
identities[*].avatar_url
string
(required)
The URL of this identity's avatar image.
identities[*].display_name
string
(required)
identities[*].external
object
(required)
External links for an identity.
identities[*].external.profile
string
(required)
A link to this identity's profile page.
identities[*].external.settings
string
A link to the Rivet settings page.
identities[*].identity_id
string
(required)
identities[*].is_registered
boolean
(required)
Whether or not this identity is registered with a linked account.
identities[*].presence
object
Information about the identity's current status, party, and active game.
identities[*].presence.game_activity
object
The game an identity is currently participating in.
identities[*].presence.game_activity.game
object
(required)
identities[*].presence.game_activity.game.banner_url
string
The URL of this game's banner image.
identities[*].presence.game_activity.game.display_name
string
(required)
identities[*].presence.game_activity.game.game_id
string
(required)
identities[*].presence.game_activity.game.logo_url
string
The URL of this game's logo image.
identities[*].presence.game_activity.game.name_id
string
(required)
A human readable short identifier used to references resources. Different than a uuid
because this is intended to be human readable. Different than DisplayName
because this should not include special characters and be short.
identities[*].presence.game_activity.message
string
(required)
A short activity message about the current game activity.
identities[*].presence.game_activity.mutual_metadata
object
JSON data seen only by the given identity and their mutual followers.
identities[*].presence.game_activity.public_metadata
object
JSON data seen by anyone.
identities[*].presence.status
string
(required)
The current status of an identity. This helps players understand if another player is currently playing or has their game in the background.
identities[*].presence.update_ts
string
(required)
suggested_groups
array<object>
(required)
suggested_groups[*].avatar_url
string
The URL of this group's avatar image.
suggested_groups[*].bio
string
(required)
Follows regex ^(?:[^\n\r]+\n?|\n)5$
suggested_groups[*].display_name
string
(required)
suggested_groups[*].external
object
(required)
External links for this group.
suggested_groups[*].external.profile
string
(required)
A link to this group's profile page.
suggested_groups[*].group_id
string
(required)
suggested_groups[*].is_current_identity_member
boolean
(required)
Whether or not the current identity is a member of this group.
suggested_groups[*].member_count
integer
(required)
suggested_groups[*].owner_identity_id
string
(required)
suggested_groups[*].publicity
string
(required)
The current publicity value for the given group.
suggested_players
array<object>
(required)
suggested_players[*].account_number
integer
(required)
suggested_players[*].avatar_url
string
(required)
The URL of this identity's avatar image.
suggested_players[*].display_name
string
(required)
suggested_players[*].external
object
(required)
External links for an identity.
suggested_players[*].external.profile
string
(required)
A link to this identity's profile page.
suggested_players[*].external.settings
string
A link to the Rivet settings page.
suggested_players[*].identity_id
string
(required)
suggested_players[*].is_registered
boolean
(required)
Whether or not this identity is registered with a linked account.
suggested_players[*].presence
object
Information about the identity's current status, party, and active game.
suggested_players[*].presence.game_activity
object
The game an identity is currently participating in.
suggested_players[*].presence.game_activity.game
object
(required)
suggested_players[*].presence.game_activity.game.banner_url
string
The URL of this game's banner image.
suggested_players[*].presence.game_activity.game.display_name
string
(required)
suggested_players[*].presence.game_activity.game.game_id
string
(required)
suggested_players[*].presence.game_activity.game.logo_url
string
The URL of this game's logo image.
suggested_players[*].presence.game_activity.game.name_id
string
(required)
A human readable short identifier used to references resources. Different than a uuid
because this is intended to be human readable. Different than DisplayName
because this should not include special characters and be short.
suggested_players[*].presence.game_activity.message
string
(required)
A short activity message about the current game activity.
suggested_players[*].presence.game_activity.mutual_metadata
object
JSON data seen only by the given identity and their mutual followers.
suggested_players[*].presence.game_activity.public_metadata
object
JSON data seen by anyone.
suggested_players[*].presence.status
string
(required)
The current status of an identity. This helps players understand if another player is currently playing or has their game in the background.
suggested_players[*].presence.update_ts
string
(required)
watch
object
(required)
Provided by watchable endpoints used in blocking loops.
watch.index
string
(required)
Index indicating the version of the data responded.
Pass this to WatchQuery
to block and wait for the next response.