Skip to main content
GET
List league submissions

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Query Parameters

league_id
string | null

Return submissions to this league only.

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

Return submissions for this player only.

Pattern: ^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
policy_version_id
string<uuid> | null

Return submissions for this policy version only.

status
enum<string>[] | null

Return submissions in any of these lifecycle states.

Available options:
pending,
processing,
placed,
rejected,
withdrawn
mine
boolean
default:false

Return submissions owned by the caller.

limit
integer
default:200

Maximum submissions to return.

Required range: 1 <= x <= 1000
cursor
string | null

Continuation token from the previous response's X-Next-Cursor header.

Response

Successful Response

id
string
required

Submission ID.

status
enum<string>
required

Current submission state.

Available options:
pending,
processing,
placed,
rejected,
withdrawn
league
LeaguePublic · object
required

League receiving the submission.

policy_version
PolicyVersionPublic · object
required

Policy version submitted to the league.

player
PlayerPublic · object | null
required

Player credited for the submission, or null when none is assigned.

created_at
string<date-time>
required

Time when the submission was created.

auto_champion
enum<string>
default:always

Controls whether newer versions of this policy become the player's league champion.

Available options:
always,
never,
lineage
preferences
Preferences · object | null

League-specific submission preferences.

notes
string | null

Note attached to the submission.

league_policy_membership_id
string | null

Membership created from the submission, or null until placement succeeds.