Live Swiss Tournament Data for vMix
The Swiss Groups API provides real-time tournament standings data specifically formatted for vMix / OBS integration during live tournament broadcasts.
Endpoint: GET /stream-info/swiss-groups/{tournament-name}
Required Parameters
divisionType
- Division type (automatically converted to uppercase)
Optional Parameters
divisionNum
- Division number (defaults to 1 if not specified)round
- Show specific round (defaults to latest round)
Available Division Types
OPEN
- Open divisionWOMEN
- Women's division (API handles internal mapping automatically)MIXED
- Mixed divisionMASTERS
- Masters division
Response Format
Returns an array of team objects, sorted by playoff status (playoff teams first), then by rating (highest first).
JSON Fields
position
(number) - Current ranking position (1-based)division
(string) - Division name (e.g., "OPEN #1", "WOMEN #2")teamTitle
(string) - Team nameteamCity
(string) - Team's club cityteamCountry
(string) - Team's club countryclubAvatarUrl
(string) - Team's club logo URL (400px version, empty if no logo)rating
(number | empty string) - Swiss system calculated rating (empty string when no games played yet)hasPlayoff
(boolean) - Whether team has qualified for playoffs
Playoff Behavior
Teams with hasPlayoff: true
always appear at the top of rankings regardless of rating. This reflects teams that have secured playoff positions in the Swiss system.
Pre-Tournament State
When no games have been played, teams are listed in seed order with rating: ""
(empty string) and hasPlayoff: false
.
Usage with vMix
This endpoint delivers JSON data containing team rankings, ratings, and playoff qualifications that can be imported into vMix as a data source for creating dynamic tournament overlays and graphics during live streams.
Examples
https://api.ultie.org/stream-info/swiss-groups/windmill2025?divisionType=OPEN
(OPEN #1, latest round)https://api.ultie.org/stream-info/swiss-groups/windmill2025?divisionType=WOMEN&divisionNum=2&round=3
(WOMEN #2, round 3)https://api.ultie.org/stream-info/swiss-groups/windmill2025?divisionType=mixed&divisionNum=1
(MIXED#1, latest round)https://api.ultie.org/stream-info/swiss-groups/windmill2025?divisionType=MIXED&round=2
(MIXED #1, round 2)
Test Data
Need sample data for testing or setting things up? Message us on Telegram or WhatsApp — we’ll quickly send you a working link with live examples.
Last updated
Was this helpful?