Friendly Competitions

GET/friendlycomps

List friendly competitions (up to 10 per call).

Query params: compid, compids (comma-sep), adminid (owner/admin filter), start (page cursor ID)

Blackout Rugby API call: https://blackoutrugby.magicrunez.com/?r=fcl

Example response:

{"data":{"8":{"id":"8","title":"WCC","short":"WCC","web":"www.blackoutwcc.com","admin":["46391","2256"]}}}

GET/friendlycomps/:id/trophies

Retrieve trophies for a competition.

Query params: season (optional, defaults to current season)

Headers: x-access-key (required)

Blackout Rugby API call: https://blackoutrugby.magicrunez.com/?r=ftr&compid=549&season=22

Example response:

{"data":{"status":"Ok","competitionid":"549","season":22,"gives_remaining":0,"trophies":[{"id":"17406","title":"Rwc","verified":"1","given_to":["2"]}]}}

POST/friendlycomps/:id/trophies

Give or retract trophies for a competition.

Headers: x-access-key (required)

Body: season (number), trophyid (string), retract (0=give, 1=retract), teamids (array of team ID strings)

Blackout Rugby API call: https://blackoutrugby.magicrunez.com/?r=ftg&compid=549&...

Example response:

{"data":{"status":"Ok","trophies_given":2}}

GET/friendlycomps/:id/fixtures

Retrieve fixture requests for a competition.

Query params: season (optional), round (optional); omit both for all current/future rounds

Headers: x-access-key (required)

Blackout Rugby API call: https://blackoutrugby.magicrunez.com/?r=fcfr&compid=479&season=21&round=7

Example response:

{"data":{"status":"Ok","fixtures":{"138622":{"id":"138622","competitionid":"479","season":"21","round":"7","hometeamid":"2","guestteamid":"19856"}}}}

POST/friendlycomps/:id/fixtures

Add or delete fixture requests. Supply "fixtures" array to add, or "delete" array of request IDs to remove.

Headers: x-access-key (required)

Body: fixtures: [{home, guest, type ("Monday"|"Thursday"|"Anytime"), season?, round?, mode?, kickoff?, intensity?}] OR delete: [requestId, ...]

Blackout Rugby API call: https://blackoutrugby.magicrunez.com/?r=fcfa&compid=479&...

Example response:

{"data":{"status":"Ok","num_fixtures_added":2,"owners_messaged":4}}

Endpoints