API overview

Base address

Mode	Base address
Test and live	https://developers.arena54.com/api/v1

The key prefix (a54_test_ or a54_live_) selects the mode. Every path in this reference starts with /v1.

JSON

{
  "success": true,
  "data": {},
  "meta": {
    "request_id": "req_8f2c41d09b7e4a6f",
    "mode": "test"
  }
}

meta.request_id is also returned in the X-Request-Id header. See Errors for codes.

Topic	Behaviour
Auth	Authorization: Bearer a54_test_… or a54_live_…
Version	/v1 in the path.
Methods	GET only. The API is read-only.
JSON	snake_case fields (cover_url, country_code).
Lists	limit and cursor in, next_cursor and total out.
Dates	ISO 8601, in UTC.
Caching	Answers are sent with Cache-Control: no-store. Cache on your side.

Method	Path	Purpose
GET	/v1/games	Published games, featured first, then newest.
GET	/v1/games/{slug}	One game, with its description, screenshots, links and credits.
GET	/v1/creators	Studios and people: developers, artists, composers.
GET	/v1/creators/{handle}	One creator, with their bio, links and games.
GET	/v1/countries	Countries that have listings, with how many creators and games each has.
GET	/v1/countries/{code}	One country and its cities.
GET	/v1/cities	Cities that have creators, biggest first.
GET	/v1/genres	Every genre key and name, with how many games carry it.
GET	/v1/events	Jams, meetups, tournaments, showcases and conferences.
GET	/v1/rankings/{kind}/{board}	One of the six boards from the head-to-head votes.
GET	/v1/search	Games, creators and countries matching a word. At least two characters.