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 parameter "Has formations" informs about the availability of formation for the match and can be found in the following node:
competition → season → stage → group → event
Example:
"id": 178,"name": "Has formations","value": "yes",
If the “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 a scout to enter the proper formation. If you receive no data, recheck in a 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 a match
Depending on the selected formation, the player may take 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 the 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 are always assigned starting from the goalkeeper and then successively, from the right to the left side of the field
Formations
We are currently using 17 different formations with the players' positions listed in the table below:
Formation | Player’s position | |
|---|---|---|
| 1 | 4-4-2 |  |
| 2 | 4-3-3 |  |
| 3 | 3-4-3 |  |
| 4 | 3-4-2-1 |  |
| 5 | 4-5-1 |  |
| 6 | 5-2-2-1 |  |
| 7 | 3-5-2 |  |
| 8 | 4-3-1-2 |  |
| 9 | 4-2-3-1 |  |
| 10 | 4-4-1-1 |  |
| 11 | 5-3-2 |  |
| 12 | 3-4-1-2 |  |
| 13 | 4-1-4-1 |  |
| 14 | 4-3-2-1 |  |
| 15 | 4-1-3-2 |  |
| 16 | 4-2-2-2 |  |
| 17 | 5-4-1 |  |