Competitions

List all competition records.

Query params: none

Example response:

{"data":[{"comp_id":1,"comp_num":23,"comp_code":"WCC","comp_name":"World Club Cup","entries_open":"Y","active":"Y","day":1}]}

Fetch a single competition by its legacy comp_num value.

Query params: compNum (required)

Example response:

{"data":{"comp_id":1,"comp_num":23,"comp_code":"WCC","comp_name":"World Club Cup","entries_open":"Y","active":"Y","day":1}}

Read the current entry state and the associated season settings.

Query params: season (optional)

Example response:

{"data":{"comp_num":23,"entries_open":"Y","open":true,"season":46,"settings":[...]}}

Set whether entries are currently open. Accepts entries_open or open.

Body: entries_open ("Y"|"N"|boolean, required)

Example response:

{"data":{"comp_num":23,"entries_open":"Y","open":true,"updated":true}}

Add a team entry to a competition and season ahead of the competition start. This is a public competition-entry action, not an admin-only task.

Body: comp_num, season_num, team_id, manager_id, team_name (optional)

Example response:

{"data":{"comp_num":23,"season_num":46,"team_id":2,"manager_id":123,"inserted_id":456}}

Fetch the league table for a given season and competition.

Query params: season (required, defaults to 46)

Example response:

{"data":{"comp_num":23,"season_num":46,"count":14,"teams":[{"team_id":2,"team_name":"Chiefs","level_num":1,"points":12,"pfor":123,"pagainst":89}]}}

Fetch the level definitions for a given season and comp.

Query params: season (required, defaults to 46)

Example response:

{"data":{"comp_num":23,"season_num":46,"count":3,"levels":[{"level_num":1,"level_name":"Premiership","count":14}]}}

List distinct seasons in which the competition has levels defined.

Query params: none

Example response:

{"data":{"comp_num":23,"count":3,"seasons":[{"season_num":46},{"season_num":45}]}}

Preview the automatically generated level split for a competition season based on current entries.

Query params: comp_num or compNum (required), season_num or seasonNum (optional, defaults to 46)

Example response:

{"data":{"comp_num":23,"season_num":46,"total_teams":16,"levels":[{"level_num":1,"level_name":"Level 1","count":8},{"level_num":2,"level_name":"Level 2","count":8}]}}

Allocate the current season entries into balanced level groups and insert them into comp_teams.

Body: comp_num, season_num

Example response:

{"data":{"comp_num":23,"season_num":46,"inserted_count":16,"levels":[{"level_num":1,"count":8}]}}

List the available legacy admin routes for managing competitions and match data.

Query params: none

Example response:

{"data":{"source":"legacy-comp-admin","routes":["getdata","getcompfixtures","getmatchsummary","getreportersummaries","loadround","savematchdata","competitions","entry-state","levels","teams","settings"]}}

Legacy admin data proxy for direct Blackout Rugby API lookups using a raw legacy page string.

Query params: page (required, e.g. "r=ms&fixtureids=123")

Example response:

{"data":{"status":"Ok","fixtures":[...]}}

Return the fixtures for a competition, season, and round in the same shape the legacy admin script expects.

Query params: comp_num or c (required), season_num or s (required), round_num or r (optional, defaults to 1)

Example response:

{"data":{"comp_num":23,"season_num":46,"round_num":1,"count":4,"fixtures":[...]}}

Return the match summaries for a given competition round.

Query params: comp_num or c (required), season_num or s (required), round_num or r (optional, defaults to 1)

Example response:

{"data":{"comp_num":23,"season_num":46,"round_num":1,"count":4,"fixtures":[...]}}

Return the reporter summary data associated with a competition round.

Query params: comp_num or c (required), season_num or s (required), round_num or r (optional, defaults to 1)

Example response:

{"data":{"comp_num":23,"season_num":46,"round_num":1,"count":4,"summaries":[...]}}

Legacy compatibility route for loading round results in the old admin/test.php style. Accepts c, s, and r query params.

Query params: c or comp_num (required), s or season_num (required), r or round_num (optional, defaults to 1)

Example response:

{"data":{"comp_num":23,"season_num":62,"round_num":2,"count":4,"fixtures":[...]}}

Explicit alias for the legacy round-load workflow; same behavior as /comp/admin/load.

Query params: c or comp_num (required), s or season_num (required), r or round_num (optional, defaults to 1)

Example response:

{"data":{"comp_num":23,"season_num":62,"round_num":2,"count":4,"fixtures":[...]}}

Load fixture data for a competition round in the same style as the legacy admin loader.

Query params: comp_num or c (required), season_num or s (required), round_num or r (optional, defaults to 1)

Example response:

{"data":{"comp_num":23,"season_num":46,"round_num":1,"count":4,"fixtures":[...]}}

Persist admin-updated match result rows into comp_result.

Body: results: [{comp_num, season_num, round_num, home_id, guest_id, home_score, guest_score, fixture_id}]

Example response:

{"data":{"saved_count":1,"saved":[{"result_id":123,"updated":false}]}}

Return all competition metadata rows from the comp_info table for admin workflows.

Query params: none

Example response:

{"data":{"count":2,"competitions":[{"comp_num":23,"comp_name":"World Club Cup","entries_open":"Y","active":"Y"}]}}

Update admin-editable competition metadata such as name, code, active state, or entries_open.

Body: comp_name, comp_code, entries_open, active, season, introduction

Example response:

{"data":{"comp_num":23,"comp_name":"World Club Cup","entries_open":"Y","active":"Y"}}

Admin list of level setup rows for a given competition and season.

Query params: comp_num or compNum (required), season_num or seasonNum (optional, defaults to 46)

Example response:

{"data":{"comp_num":23,"season_num":46,"count":3,"levels":[{"level_num":1,"level_name":"Premiership","count":14}]}}

Create or update a level definition for a competition season.

Body: comp_num, season_num, level_num, level_name, count

Example response:

{"data":{"created":true,"level":{"comp_num":23,"season_num":46,"level_num":1,"level_name":"Premiership","count":14}}}

Admin list of teams registered against a competition and season.

Query params: comp_num or compNum (required), season_num or seasonNum (optional, defaults to 46)

Example response:

{"data":{"comp_num":23,"season_num":46,"count":12,"teams":[{"team_id":2,"team_name":"Chiefs","level_num":1}]}}

Create or update a team entry in a competition season.

Body: comp_num, season_num, team_id, team_name, level_num, stars, ranking, nation

Example response:

{"data":{"created":true,"team":{"comp_num":23,"season_num":46,"team_id":2,"team_name":"Chiefs","level_num":1,"stars":0,"ranking":0,"nation":"ZA"}}}

Read the comp_settings table used for admin configuration values.

Query params: none

Example response:

{"data":{"count":3,"settings":[{"keyname":"entries_open","value":"Y"}]}}