Skip to main content
GET
Get landscape board

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Path Parameters

league_id
string
required

League whose landscape board should be returned.

Pattern: ^league_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Response

Successful Response

league_id
string
required

League whose landscape board is returned.

enabled
boolean
required

Whether landscape rounds are enabled.

config
Config · object
required

Public landscape geometry and round settings.

players
Players · object[]
required

Visible players and their board symbols.

viewer_player_ids
string[]
required

Players on this board owned by the caller.

map_refs
string[]
required

Coworld variant ID for each bounding-grid position.

modes
string[]
required

Match mode for each bounding-grid position.

map_seeds
(integer | null)[]
required

Generated-map seed for each bounding-grid position.

map_sizes
(string | null)[]
required

Generated-map size for each bounding-grid position.

preview_urls
(string | null)[]
required

Authored map preview for each bounding-grid position.

blob_ids
integer[] | null
required

Contiguous board-region ID for each grid position.

owners
(string | null)[]
required

Leading player for each bounding-grid position.

ladders
LandscapeLadderRow · object[][]
required

Top cell-ladder entries for each grid position.

round
integer
required

Number of completed landscape rounds.

last_round_at
string | null
required

UTC completion time of the latest landscape round.

pending
boolean
required

Whether a landscape round is currently in flight.

color_prefs
Color Prefs · object
required

Preferred board-palette slot keyed by player ID.

frames_count
integer
required

Number of retained landscape history frames.