> For the complete documentation index, see [llms.txt](https://docs.ultie.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ultie.org/integrations/live-swiss-feed.md).

# Live Swiss standings feed

Connect live Swiss standings to a broadcast overlay in vMix or another production tool.

## Build the feed URL

Use this endpoint:

```
https://api.ultie.org/stream-info/swiss-groups/{event-slug}
```

Add the required `divisionType` query parameter:

```
https://api.ultie.org/stream-info/swiss-groups/{event-slug}?divisionType=OPEN
```

| Parameter      | Required | Value                                     |
| -------------- | -------: | ----------------------------------------- |
| `divisionType` |      Yes | `OPEN`, `WOMEN`, `MIXED`, or `MASTERS`    |
| `divisionNum`  |       No | division number; defaults to `1`          |
| `round`        |       No | Swiss round; defaults to the latest round |

Division types are case-insensitive and are converted to uppercase.

For example, this requests Mixed division 1 after round 2:

```
https://api.ultie.org/stream-info/swiss-groups/{event-slug}?divisionType=MIXED&divisionNum=1&round=2
```

Replace `{event-slug}` with the slug from the public event URL.

## Available fields

The response is an array of team objects.

| Field           | Description                                                    |
| --------------- | -------------------------------------------------------------- |
| `position`      | Current position                                               |
| `division`      | division name and number                                       |
| `teamTitle`     | team name                                                      |
| `teamCity`      | team city                                                      |
| `teamCountry`   | team country                                                   |
| `clubAvatarUrl` | team image URL                                                 |
| `rating`        | Current Swiss rating, or an empty value before the first games |
| `hasPlayoff`    | Whether the team has qualified for playoffs                    |

## Ordering

Teams with `hasPlayoff: true` appear first. The remaining teams are sorted by rating.

Before the first games, the feed follows the initial seeding, `rating` is empty, and `hasPlayoff` is `false`.

## Current Women division naming

Use `WOMEN` in the `divisionType` request. The response's `division` field currently returns `WOMAN #…` for that division.

If an integration filters the response programmatically, do not rely on the display spelling in `division`.

## Connect the feed to vMix

1. Add a JSON **Data Source** in vMix.
2. Paste the feed URL with the required query parameters.
3. Set the refresh interval required for the broadcast.
4. Link the standings fields to the corresponding fields in the Title input.