Starting from the 2021/22 season, STATSCORE offers a formations preview for selected matches.
Formations availability for the match
You can receive this information through endpoints events.show and events.index
The event details "Has formations" informs about the availability of formation for the match and can be found in the node:
competition → season → stage → group → event
Example:
"id": 178,"name": "Has formations","value": "yes",
If “Has formation” parameter’s value is equal to:
“no”, formations are not available for the chosen event
“soon”, formations will be available for the chosen event in the next few minutes
“yes”, formations are available for the chosen event
Please, be informed that it may take a short while for scout to enter the proper formation. If you receive no data, recheck in couple of minutes.
Team’s formation for selected match
You can receive this information through events.show and events.index endpoints.
Information about the chosen formation for the team can be found in the team's statistics at the node:
competition → season → stage → group → event → participants
Example:
"id": 716,"short_name": "Form.","name": "Form.","value": "4-4-2","data_type": "text"
Assigning players to positions for the formation in the match
Depending on the selected formation, the player may assume different positions on the field. Their exact location is graphically presented in the table below and is the same as the "Player's position" statistic assigned to a player. The “Players position” statistics are available through events.sub-participants.index endpoint.
Example:
"id": 717,"name": "Player's position","short_name": "P. position.","value": 11,"data_type": "integer"
Please, be informed that for each formation, the players' position values are numbered from 1 to 11 and they are assigned always starting from the goalkeeper and then successively from right to left side of the field.
Formations
We are currently using 12 different formations with the player’s positions listed in the table below:
Formation | Player’s position | |
|---|---|---|
| 1 | 4-4-2 |  |
| 2 | 4-3-3 |  |
| 3 | 3-4-3 |  |
| 4 | 3-6-1 |  |
| 5 | 3-4-2-1 |  |
| 6 | 4-5-1 |  |
| 7 | 5-2-2-1 |  |
| 8 | 3-5-2 |  |
| 9 | 4-3-1-2 |  |
| 10 | 4-2-3-1 |  |
| 11 | 4-4-1-1 |  |
| 12 | 5-3-2 |  |