Get Game Versions

Retrieve all versions of a specific game organized by platform and release type.

Endpoint

GET /api/v2/public/games/{slug}/versions

Authentication

This endpoint is public and does not require authentication.

Description

This endpoint returns all versions of a specific game organized by platform (web, mobile, desktop) and release type (production, alpha, beta). Each version includes detailed metadata and download information.

Path Parameters

Parameter	Type	Required	Description
slug	string	Yes	Unique identifier for the game

Request Example

GET /api/v2/public/games/my-awesome-game/versions

Response

Success Response (200)

{
  "web": {
    "production": [
      {
        "name": "Web Production v1.2.0",
        "description": "Latest stable web version",
        "bannerImage": "https://example.com/web-banner.jpg",
        "platform": "web",
        "releaseType": "production",
        "changeLog": "Added new features and bug fixes",
        "buildNumber": "120-prod",
        "visibleVersion": "1.2.0",
        "downloadUrl": "https://game.example.com/play",
        "clientKey": "abc123def456",
        "createdAt": 1704110400000,
        "updatedAt": 1704110400000
      }
    ],
    "beta": [
      {
        "name": "Web Beta v1.3.0",
        "description": "Upcoming features in beta testing",
        "bannerImage": "https://example.com/web-beta-banner.jpg",
        "platform": "web",
        "releaseType": "beta",
        "changeLog": "New UI improvements and experimental features",
        "buildNumber": "130-beta",
        "visibleVersion": "1.3.0-beta",
        "downloadUrl": "https://beta.game.example.com/play",
        "clientKey": "abc123def456",
        "createdAt": 1704196800000,
        "updatedAt": 1704196800000
      }
    ]
  },
  "android": {
    "production": [
      {
        "name": "Android Release v1.1.0",
        "description": "Stable Android version",
        "bannerImage": "https://example.com/android-banner.jpg",
        "platform": "android",
        "releaseType": "production",
        "changeLog": "Mobile optimizations and bug fixes",
        "buildNumber": "110-android",
        "visibleVersion": "1.1.0",
        "downloadUrl": "https://play.google.com/store/apps/details?id=com.example.game",
        "clientKey": "abc123def456",
        "createdAt": 1703721600000,
        "updatedAt": 1703721600000
      }
    ]
  },
  "ios": {
    "production": [
      {
        "name": "iOS Release v1.1.0",
        "description": "Stable iOS version",
        "bannerImage": "https://example.com/ios-banner.jpg",
        "platform": "ios",
        "releaseType": "production",
        "buildNumber": "110-ios",
        "visibleVersion": "1.1.0",
        "downloadUrl": "https://apps.apple.com/app/id123456789",
        "clientKey": "abc123def456",
        "createdAt": 1703721600000,
        "updatedAt": 1703721600000
      }
    ]
  }
}

Error Response (404)

{
  "message": "Game not found",
  "status": 404
}

Response Fields

Platform Structure

Field	Type	Description
web	object	Web platform versions (optional)
android	object	Android platform versions (optional)
ios	object	iOS platform versions (optional)
windows	object	Windows platform versions (optional)
macos	object	macOS platform versions (optional)
linux	object	Linux platform versions (optional)
other	object	Other platform versions (optional)

Platform Version Arrays

Field	Type	Description
production	array	Production/stable versions (optional)
alpha	array	Alpha/early access versions (optional)
beta	array	Beta/testing versions (optional)

Version Object Fields

Field	Type	Required	Description
name	string	Yes	Version name/title
description	string	Yes	Version description
bannerImage	string	Yes	Version banner image URL
platform	string	Yes	Platform type
releaseType	string	Yes	Release type
changeLog	string	No	Version changelog (optional)
buildNumber	string	Yes	Build identifier
visibleVersion	string	Yes	User-facing version number
downloadUrl	string	No	Download/play URL (optional)
clientKey	string	Yes	Game client key for authentication
createdAt	number	Yes	Creation date (Unix timestamp in ms)
updatedAt	number	Yes	Update date (Unix timestamp in ms)

Platform Types

Platform	Description
web	Web browser games
android	Android mobile games
ios	iOS mobile games
windows	Windows desktop
macos	macOS desktop
linux	Linux desktop
other	Other platforms

Release Types

Type	Description
production	Stable production release
beta	Beta/testing version
alpha	Alpha/early access version
development	Development/internal version

Usage Example

const response = await fetch("https://api.intraverse.io/api/v2/public/games/my-awesome-game/versions");

const versions = await response.json();

// Check web versions
if (versions.web) {
  console.log("Web Versions:");

  if (versions.web.production) {
    console.log(`  Production: ${versions.web.production.length} versions`);
    versions.web.production.forEach((version) => {
      console.log(`    - ${version.visibleVersion}: ${version.name}`);
    });
  }

  if (versions.web.beta) {
    console.log(`  Beta: ${versions.web.beta.length} versions`);
  }
}

// Check mobile versions
if (versions.android) {
  console.log("Android Versions:");
  versions.android.production?.forEach((version) => {
    console.log(`  - ${version.visibleVersion}: ${version.description}`);
    console.log(`    Download: ${version.downloadUrl}`);
  });
}

if (versions.ios) {
  console.log("iOS Versions:");
  versions.ios.production?.forEach((version) => {
    console.log(`  - ${version.visibleVersion}: ${version.description}`);
  });
}

Platform Organization

Versions are organized by platform, then by release type:

{
  "web": {
    "production": [...],
    "beta": [...],
    "alpha": [...]
  },
  "android": {
    "production": [...],
    "beta": [...]
  }
}

Error Handling

Error	Description	Solution
Game not found	Game slug doesn't exist	Verify the game slug

Next Steps

• Games API Overview
• Get Public Game
• API Reference