OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

GET User Season List

/openmlbb/user/season

Open Only This

API Path: /api/user/season

Retrieve the authenticated player's season information using a valid JWT. Supports query parameter for localization (lang). Requires an Authorization header with the JWT from login.

Headers:

  • Authorization: Bearer <jwt> (JWT obtained during login).

Query parameters:

  • lang: Language code for localized content (default: en).

The response includes:

  • sids: List of season identifiers representing the seasons in which the player has participated or has tracked statistics.

This endpoint is useful for:

  • Displaying season history.
  • Linking performance data to specific seasons.
  • Enabling clients to fetch season-specific stats or achievements.

This endpoint requires JWT. Pass the token via the SDK call argument jwt="YOUR_JWT".

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.user.season(jwt="YOUR_JWT", lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
lang query string no en