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 division

  • WOMEN - Women's division (API handles internal mapping automatically)

  • MIXED - Mixed division

  • MASTERS - 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 name

  • teamCity (string) - Team's club city

  • teamCountry (string) - Team's club country

  • clubAvatarUrl (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)

Division types are case-insensitive and automatically converted to uppercase. Use "WOMEN" (the API handles the internal database mapping automatically).

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?