Overview

For further information about the type of penalties, please see Sanctions. If a sanction involves any point decrement due to a penalty, then the action has two parts. The first part is always a Sanction packet that describes the reason of a sanction (yellow and red card for the 1st time, or for the 2nd time, etc), followed by a PenaltyPoint packet that contains the actual scores of the match, indicating a 1 point or 2 points decrements.

1. Player - Yellow Card 🟨

2. Coach - Yellow Card 🟨 (Currently not supported)

3. Player - Yellow and Red Card (1st) 🟨 🟥

4. Player - Yellow and Red Card (2nd) 🟨 🟥

1. Player - Yellow Card (Warning) 🟨

Showing a yellow card by the umpire is a warning to the player. If the player repeats the action or do something else wrong they can get a red card and then lose a point (See Penalty Points). A Sanction packet, along with the sanction type will be emitted. (no penalty points).

{
    "eventElementType": "Sanction",
    "id": 0,
    "seqNum": 51,
    "sanctionType": "PlayerYellowCard",
    "team": "TeamA",
    "game": 2,
    "timestamp": "1970-01-01T00:00:00.000Z"
}

1. Coach - Yellow Card 🟨 (Currently not supported)

Showing a yellow card by the umpire is a warning to the coach. A Sanction packet, along with the sanction type will be emitted. (no penalty points).

{
    "eventElementType": "Sanction",
    "id": 0,
    "seqNum": 51,
    "sanctionType": "CoachYellowCard",
    "team": "TeamA",
    "game": 2,
    "timestamp": "1970-01-01T00:00:00.000Z"
}

1. Player - Yellow & Red Card (1st) 🟨 🟥

Showing a yellow and red card together for the 1st time means the player repeated any wrongdoing or did something else wrong and now losing a point (See Penalty Points). After the Sanction packet, a PenaltyPoint packet is emitted showing the current state of scores - 1 point decrement is expected.

{
    "eventElementType": "Sanction",
    "id": 0,
    "seqNum": 51,
    "sanctionType": "PlayerYellowRedOne",
    "team": "TeamA",
    "game": 2,
    "timestamp": "1970-01-01T00:00:00.000Z"
}

1. Player - Yellow & Red Card (2st) 🟨 🟥

Showing a yellow and red card together for the 2nd time means the player repeated any wrongdoing or did something else wrong and now losing a point (See Penalty Points). After the Sanction packet, a PenaltyPoint packet is emitted showing the current state of scores - 2 points decrement is expected.

{
    "eventElementType": "Sanction",
    "id": 0,
    "seqNum": 51,
    "sanctionType": "PlayerYellowRedTwo",
    "team": "TeamA",
    "game": 2,
    "timestamp": "1970-01-01T00:00:00.000Z"
}

1. Penalty Point(s)

Showing a yellow and red card together means the player repeated any wrongdoing or did something else wrong, and one or two points are awarded to the opponent for the offence(s). Before a PenaltyPoint packet, a Sanction is expected to be received (See Player Yellow and Red 1 Card or Player Yellow and Red 2 Card), and the current state of scores is being sent as part of the PenaltyPoint packet.

{
    "eventElementType": "PenaltyPoint",
    "id": 0,
    "seqNum": 26,
    "team": "TeamA",
    "matchScore": {
        "pointsA": 0,
        "pointsB": 0
    },
    "scores": [
        {
            "pointsA": 0,
            "pointsB": 11
        },
        {
            "pointsA": 5,
            "pointsB": 5
        },
        {
            "pointsA": 0,
            "pointsB": 0
        },
        {
            "pointsA": 0,
            "pointsB": 0
        },
        {
            "pointsA": 0,
            "pointsB": 0
        }
    ],
    "game": 2,
    "timestamp": "1970-01-01T00:00:00.000Z"
}

Disqualification

The referee has the power to disqualify player(s) from a match for a seriously unfair or offensive behaviour by holding up a red card. In this case the match will end and a MatchFinished event type is submitted, indicating the reason of a player being disqualified.

{
    "timestamp": "2021-07-20T16:17:45.426Z",
    "eventElementType": "MatchFinished",
    "reason": "Disqualification",
    "seqNum": 656,
    "won": "TeamA"
}

Overview

Players and coaches can be sanctioned by umpires and referees using yellow and red cards.

Note: sanctions are currently not supported about coaches.