> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/soccer/action-types.md).
# Action Types
An action type can be something like a goal, card, dangerous attack. The sub action type gives extra context to that initial action type. i.e. a goal (action type) scored from inside the box (sub action type). Actions data could relate to player actions, such as the number of shots, passes, crosses, challenges, corners, forwards, offsides, or deflections, etc.
Or, team actions, such as the number of kick-offs, goal kicks, throw-ins, corner kicks, free kicks, or penalty kicks, etc.
Or, referee actions, such as the number of goals disallowed, dropped balls, substitutions, cautions or dismissals, etc.
Match data can be:
* The name of the referee
* Which players are within the teams
* Which colors are being worn by the team
* What the environment is like on the given day, i.e. the weather conditions
For a list of actions that support the different sendTypes, please refer to our FAQs section [here](/soccer/frequently-asked-questions.md) towards the bottom of the page
| Action Type Id | Action Type Name | Description |
| -------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | Match Conditions | includes information like pitch condition, outfield speed, weather, wind.
Pitch conditions
0 - grass
1 - clay
2 - hard
3 - artificial grass
Quality
0 - poor
1 - average
2 - good
weather condition:
rain
0 - none
1 - mild
2 - moderate
3 - heavy
wind
0 - none
1 - low
2 - medium
3 - high
temperature
0 - freezing
1 - cold
2 - mild
3 - warm
4 - hot
5 - extremely hot
|
| 2 | Team Colours | the colours that the teams are wearing |
| 3 | Lineups | the player, coaches and officials taking part in the match |
| 4 | Start Fixture / Match | match has started |
| 5 | End Fixture / Match | match has ended |
| 6 | Start Period | period has started |
| 7 | End Period | period has ended |
| 8 | Start Clock | clock started at X time |
| 9 | Stop Clock | clock stopped at Y time |
| 10 | Edit/Adjust clock | stopped clock adjusted to Z time |
| 13 | Substitution In | player coming into the match |
| 14 | Substitution Out | player leaving the match |
| 18 | Distress | A signal from the data collection analyst:
1801: Device Issues
1802: Sickness
1803: Integrity issue
1804: Other
This is most likely to be used for sickness (scorer has a medical emergency), or 'Integrity issues' if they are approached/threatened by someone to delay actions for financial reward.
\*UPDATE: This action will be retired in 2024. This action is principally used by scouts to notify internal operations at IMGA of issues at stadium, and isn’t really of relevance to customers. The appropriate collection suspension, Close Market and Data Review actions will be used when markets require closing.
|
| 19 | Device Location | The location of the device where the data is being collected from. This is more for internal purposes. |
| 21 | Post Match Check Complete | The post most checks have been completed and no other actions will be modified. |
| 22 | Status Updated | The is when a status is being updated. To be used in conjunction with currentStatus and collectionStatus in fixtureSummary |
| 24 | Players Ready | Players are warming up and ready. From 1st June 2026 this action will be available for period = 1 only |
| 51 | Video Check Underway | decision is being reviewed by video official:
5101: Potential Disallowed Goal
5102: Potential Penalty
5103: Potential Red Card
5104: Other
|
| ~~56~~ | ~~Match delayed~~ | match has been delayed for a significant period due to
5601: Weather
5602: Crowd trouble
5603: Other
To be removed from 1st June 2026. Clients should look for a change to the startDateUTC in the fixtures API
|
| 57 | Additional Time | the estimated amount of additional time signalled by the official in minutes.
5700: 0
5701: 1
5702: 2
5703: 3
5704: 4
5705: 5
5706: 6
5707: 7
5708: 8
5709: 9
5710: 10
5711: 11
5712: 12
5713: 13
5714: 14
5715: 15
5716: 16
5717: 17
5718: 18
5719: 19
5720: 20
5721: 21
5722: 22
5723: 23
5724: 24
5725: 25
5726: 26
5727: 27
5728: 28+
5799: Unknown
(updated 18th Sept 2023
|
| 58 | Play Stopped | decision is being reviewed by video official
5801: Injury
5802: Pitch Invasion
5803: Crowd Trouble
5804: Other
5805: Water Break
|
| 59 | Player left | player left the pitch temporarily |
| 60 | Player returned | player returned to the pitch |
| 61 | Video Check Result | result of the video check is returned:
6101: Goal Disallowed
6102: Goal Allowed
6103: No Penalty
6104: Penalty Awarded
6105: No Red card
6106: Red Card
IMPORTANT - will be deprecated, and replaced by Video Check Over (71) W/C 20th Nov 23
|
| 63 | Play Resumed | The play has resumed after being stopped |
| 64 | Possible Video Check | video check could happen imminently |
| 66 | Close Market | Add a close market flag when something very unexpected happens in a match. For example there is a big brawl between players it's assumed the referee will show some cards but we don't know how many and to whom. In that case, we close the market |
| 67 | Open Market | Linked to above when the match is back to normal |
| 68 | No video check | No video check will take place |
| 71 | Video Check Over | The video check is over- this will be replacing Video Check Result (61). More info [here](/soccer/frequently-asked-questions.md#what-are-the-new-enhancements-for-var-in-october-2023) |
| 72 | Data Review Underway | This will inform Operators that we suspect an inaccuracy around a certain data point that has been collected, and the process of checking that is underway. This update aims to enhance our service offerings and improve the overall betting experience. Data Review Underway will be relevant for:
• Goals (7211)
• Substitutions (7213)
• Red Cards (7214)
• Yellow Cards (7215)
• Corners (7216)
Data Review Underway will be removed from 1st June 2026 upon the following:
• Goalscorer (7212)
• Penalties (7217)
Supported sendTypes include Confirmed, Updated and Deleted
|
| 73 | Data Review Over | Linked to the above- this is a notification that the review is now over.
Data Review Over action will be removed from 1st June 2026 upon the following:
• Goalscorer (7212)
• Penalties (7217)
Supported sendTypes include Confirmed, Updated and Deleted
|
| 101 | Safe | When one of the teams has possession of the ball on their own half. Players are passing between each other while trying to prepare an offensive action. |
| 102 | Attack | Data Collector will input this action when one of the teams constructs an offensive action towards the opponent's goal in the opponent's half |
| 103 | Dangerous Attack | an offensive play towards the opponent's goal with a high probability of scoring a goal. Data Collector will mark dangerous attack in several situations:
- when the attacking player is about to cross (as we don't know what the result of the cross would be)
- when the attacking player is in a good position to shot (no defenders around)
- when the attacking player runs to the goal net bypassing the defenders and is alone with only the goalkeeper in front of him
- when the attacking team throws the ball over an opposing defender and maintains possession
- when the attacking player running from the side has bypassed the last defender and has a good chance of entering the penalty area; when the player picked up the ball from the opponents' advanced defender.
|
| 104 | Goal | a goal may have been scored and will be confirmed or cancelled shortly
10401: Penalty Goal
10402: Own Goal
|
| 105 | Red Card | a red card may be awarded and will be confirmed or cancelled shortly.
10501: Straight Red
10502: Second Yellow
|
| 106 | Penalty Awarded | a penalty may be awarded and will be confirmed or cancelled shortly
10601: Foul
10602: Handball
10603: Other
|
| 107 | Yellow Card | a yellow card may be awarded and will be confirmed or cancelled (includes reason for card) |
| 108 | Corner Taken | corner kick taken |
| 109 | Goal Kick
It will be renamed "Goal Kick Awarded" on July 10, 2024.
| goal kick awarded |
| 110 | Offside | offside given |
| 111 | Shot | attacking team had a shot on goal
11102: On Target
11103: Blocked
11104: Woodwork (Off Target)
11105: Wide/Over (Off Target)
|
| ~~113~~ | ~~Throw In Taken~~ | ~~throw in taken. SendType must be pending when awarded and confirmed when taken~~ From 1st June 2026, this action will no longer be provided. Only Throw In Awarded will be. |
| 115 | Dangerous Free Kick
It will be renamed "Dangerous Free Kick Awarded" on July 10, 2024.
| dangerous free kick awarded on the edge of the box or on the wing and therefore a shot or a cross is expected
Data Collector should use it for free kicks that happen near an opponent's penalty area, so there is a chance to score a goal by direct shot or assisting pass. However, DC should also use it on a last minute free kick when GK from losing team runs into opponents penalty area.
New sub-action types will be available on July 10, 2024:
11501 : Foul
11502 : Handball
11503 : Other
|
| 116 | Penalty Missed | penalty missed or saved during the match or in a shootout
1161: Woodwork
1162: Wide/Over
1164: Saved
|
| ~~117~~ | ~~Goal Disallowed~~ | goal was disallowed by the official
11701 Foul
11702 Offside
11703 Handball
11704 Other
This action will no longer be provided.
Instead goal action that has not taken place will be deleted from the feed.
|
| 118 | Free Kick
It will be renamed "Free Kick Awarded" on July 10, 2024.
| free kick awarded for a foul, handball or offside. Data Collector should be using this in a situation where there is no immediate risk of a goal being scored. It is for the free kicks taken in their own half of the field and far enough back to not be part of a dangerous attack.
New sub-action types will be available on July 10, 2024:
11801 : Foul
11802 : Handball
11803 : Offside
11804: Other
|
| ~~119~~ | ~~Penalty Retake~~ | The penalty is to be retaken as signed by the referee
1191 Encroachment
1192 Goalkeeper Off Line
1193 Other
New workflow will exclude any specific action for a retaken penalty
Penalty missed/scored action is going to be deleted and then new penalty missed/scored action is going to be recoded.
|
| 121 | Kick Off | a kick off action |
| 122 | Shootout Penalty Taker | the taker of the penalty in the shootout |
| 123 | Shootout Penalty Scored | the shootout penalty was scored |
| 124 | Shootout Penalty Missed | the shootout penalty was missed |
| 126 | Throw In Awarded | a throw in has been awarded |
| 127 | Corner Awarded | a corner has been awarded |
| ~~129~~ | ~~Corner Retake Awarded~~ | ~~The retake of a corner kick if awarded (coming W/C 17th July 23)~~ This will be removed from 1st June 2026. New workflow will no longer provide this action. Instead, show the correct overall tally. |
| ~~130~~ | ~~Corner Retaken~~ | ~~When a corner is retaken (coming W/C 17th July 23)~~ This will be removed from 1st June 2026. New workflow will no longer provide this action. Instead, show the correct overall tally |
| ~~131~~ | ~~Retake penalty Shootout~~ | To be removed from 1st June 2026 |
| 132 | No Card | There was not a card awarded after all **(ON HOLD)** |
| 133 | Temporary Dismissal Started | Refers to when a player is temporarily suspended from the match for a specified duration due to an offence, effectively reducing their team to ten players for the dismissal period. |
| 134 | Temporary Dismissal Stopped | Denotes the end of a player’s temporary suspension period, allowing them to rejoin the match and restore their team to full strength. |
| 137 | Foul Committed
| Indicates a player has committed a foul, resulting in a stoppage of play and a free kick awarded to the opposing team. |
| ~~138~~ | Free Kick Taken
| ~~Denotes the execution of a free kick by a player after a foul has been committed.~~ On 1st June 2026 this action will no longer be provided. Only Free Kick Awarded will be. |
| 139 | Goal Kick Taken
| Indicates the resumption of play with a goal kick, awarded when the ball goes out of play over the goal line without a goal being scored, last touched by an attacking player. |
| 140 | Dangerous Free Kick Taken
| Refers to a free kick taken from a position that poses a significant scoring opportunity. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sportradar.com/soccer/action-types.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.