API Preview: Player Activity API

We're releasing a new API in preview today: player activity.

The player activity API returns an array of at most 10 activity entries for the given UUID. Supported activities are currently game (round) played and locker item unlocked.

An empty array will be returned if no recent activities exist, or for sessions in which the player had the Appear Offline toggle enabled. Players can currently opt out of this API by appearing offline permanently - an additional toggle will be added soon. Activities will NOT update until the player has finished their session (logged out): this is an anti-sniping measure, and we're looking into ways to either opt-in to public live updates, or other solutions such as delays.

This is our first endpoint that properly supports Etag: if your request matches our cache, 304 Not Modified is returned, and you won't impact your main rate limit. Simply send the latest Etag value in the If-None-Match header to utilize this.

https://api.playhive.com/v0/player/activity/UUID

ROUND_PLAYED example:

{
  "time": 1731372040,
  "type": "ROUND_PLAYED",
  "game": "dr",
  "victory": false
}

LOCKER example:

{
  "time": 1731368673,
  "type": "LOCKER",
  "unlock_type": "avatar",
  "unlock_id": "744742ac-bf38-4f43-b292-702d347ec497"
}

Unlock IDs are compatible with existing catalogue APIs, and for unimplemented catalogue endpoints, will be compatible once those release.

We'll be implementing additional activities, and expanding the information in the current ones. For suggestions and feedback, email us at api[@]hivemc.com.

We only read/action emails about the api.playhive.com public API, all other emails will be deleted. This is not a generic support email. Depending on volume and priorities, we can't promise that all emails will get a (timely) response.