---
title: "Fairplay table"
method: GET
path: "/tournaments/{tournament_id}/seasons/{season_id}/fairness"
tags: ["Season"]
---

# Fairplay table

`GET /tournaments/{tournament_id}/seasons/{season_id}/fairness`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/tournaments/{tournament_id}/seasons/{season_id}/fairness`
- Auth: API key in query parameter `auth_token`

Fairplay table for given season.

## Path parameters

- `tournament_id` integer, required
- `season_id` integer, required

## Response `200`

OK

- object
  - `data` object
    - `season_id` integer: ID of the season.
    - `teams` object[]: All teams and its relevant attributes in the fairness ranking.
      - `id` integer: ID of the Team.
      - `name` string: The teams name.
      - `nickname` string: The teams nickname.
      - `yellow_cards` integer: Number of yellow cards for this team.
      - `yellow_red_cards` integer: Number of yellow red cards for this team.
      - `red_cards` integer: Number of red cards for this team.
      - `points` integer: Commulated fairness point, less points -> better position in the ranking. **Formular:** points = (number red cards) x 5 + (number yellow red cards) * 3 + number yellow cards
      - `rank` integer: Position of this team in the fairness ranking.
      - `club` object: The club the team belongs to.
        - `id` integer: The Club id.
        - `link` string: The url to the club resource in the api.
        - `emblem` object: The club emblem in different resolutions.
          - `mini` string: URL of the club emblem in a mini resolution (36px by 36px).
          - `small` string: URL of the club emblem in a small resolution (70px by 70px).
          - `medium` string: URL of the club emblem in a medium resolution (300px by 300px).

## Other responses

- `304`: Not Modified
- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/clubplatform/apis/clubplatform-api.md) - [All operations](https://skmtc.dev/clubplatform/apis/clubplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clubplatform/apis/clubplatform-api/revisions/5c107a185e03?raw)