July 9th, 2023

notification

API additions: map information

This update regards our API, a programmatic way to access some of the Hive's data. It's mainly intended for a more technical audience. For more information about our API, check outΒ our support site.Β 

Map information is now available on the API. The new /game/map/:game endpoint lists all the enabled maps for the given game

Please note the following:

  • Disabled and/or removed maps will not show, there is no "archive".
  • Season is one of NO_SEASON,WINTERFEST,SPRING,HALLOWEEN,AUTUMN,SUMMER
  • Variant is one of REGULAR,DUOS,TRIOS,SQUADS,MEGA,ROYALE
  • The above enums might change, and new ones may be added: handle unexpected data safely.
  • There currently exists no way to retrieve the active season.
  • Due to seasonal maps, duplicate names can and will appear for some games. The one matching the current season is active in-game.
  • Data might be "out of date" by up to an hour.
  • Games with no, or 1, configured map(s) will return a 404.
  • As with other API endpoints, we don't guarantee the uptime, correctness or (future) existence of this endpoint and data.

Refer to the auto-generated API docs for the latest available endpoints and in-browser "try it out".