Flashscore API endpoint
Returns each side's confirmed formation, starters and substitutes with positions, in-match ratings and incidents such as cards and substitutions, plus coaches and the substitutions made. Lineups usually appear shortly before kickoff for covered matches; a match with no lineup players on either side returns not found. Use flashscore-match-predicted-lineups for expected lineups before they are confirmed.
/flashscore/match-lineupsQuery parameters:
id (required): eight-character match id from a Flashscore match URL, for example j52jHsN8.Returns one entry per side (home, then away) with the confirmed lineup:
formation: name such as 4-2-3-1 and lines[].rows[], where each row lists player_ids (row sort_key 0 is the goalkeeper). It is null when no formation is published.players: starters and substitutes with id, name, list_name, number, roles (title and suffix, for example Goalkeeper (G)), country (nationality), slug, age, height_cm, market_value (the provider's estimate; its currency is not stated) and average_rating (season average). Each player also has rating (value and is_best for this match; absent until the provider rates the player) and incidents.incidents: events attached to the player. type is the provider's incident name, for example YellowCard, SubstitutionIn or SubstitutionOut; the list is not closed, so treat unknown types as informational. Each incident has minute, reasons and, for a substituted player, player_in_id.groups: named player groups, STARTERS and SUBSTITUTES, each listing player_ids that refer to players.coaches: the listed coaches.substitutions: substitutions made, with player_in_id, player_out_id and minute.average_rating and aggregated_stats: team averages when available.Lineups usually appear shortly before kickoff for covered matches; ratings and incidents fill in during and after the match. When neither side has any lineup players the endpoint returns 404, and an unknown match id returns 404. If only one side has a lineup, the other side has empty players. Use /api/v1/flashscore/match-predicted-lineups for expected lineups before they are confirmed.
Until November 2026 this endpoint returned the provider's raw delimited text in a string data field; Flashscore stopped serving that feed, so the response is now structured JSON.
Example response (shortened):
{"code":200,"msg":"OK","data":{"source_url":"https://2.ds.lsapp.eu/pq_graphql?_hash=dlie2&eventId=6NbvG9uK&projectId=2","match_id":"6NbvG9uK","teams":[{"participant_id":"4zJjW8Rb","side":"home","name":"Sao Paulo","average_rating":7.1,"formation":{"name":"4-1-4-1","lines":[{"number":1,"rows":[{"sort_key":0,"player_ids":["Cx5lvlAM"]}]}]},"players":[{"id":"Cx5lvlAM","name":"Rafael","list_name":"Rafael","number":"23","roles":[{"title":"Goalkeeper","suffix":"(G)"}],"country":"Brazil","slug":"rafael","age":37,"height_cm":192,"market_value":380099,"average_rating":6.8,"rating":{"value":8,"is_best":false},"incidents":[]},{"id":"nLOOaaTl","name":"Pedro Lima","number":"32","rating":{"value":7.8,"is_best":false},"incidents":[{"type":"YellowCard","minute":"60'","reasons":["Tripping"]}]}],"groups":[{"type":"STARTERS","name":"Starting Lineups","player_ids":["Cx5lvlAM","nLOOaaTl"]}],"coaches":[{"id":"hWy8sVW9","name":"Dorival Junior","country":"Brazil","slug":"dorival-junior"}],"substitutions":[{"id":"AkY1pAJH","player_in_id":"S4KKxXdC","player_out_id":"6DGXE64C","minute":"46'"}],"aggregated_stats":{"average_rating":6.9,"average_height_cm":179.7,"average_age":29.3,"sum_market_value":28609520}}]}}
| Field | In the sample | Value in the sample |
|---|---|---|
| data | Has a value | 14,007 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Eight-character Flashscore match id | j52jHsN8 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-lineups?id=j52jHsN8" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://2.ds.lsapp.eu/pq_graphql?_hash=dlie2&eventId=6NbvG9uK&projectId=2",
"match_id": "6NbvG9uK",
"teams": [
{
"participant_id": "4zJjW8Rb",
"side": "home",
"name": "Sao Paulo",
"average_rating": 7.1,
"formation": {
"name": "4-1-4-1",
"lines": [
{
"number": 1,
"rows": [
{
"sort_key": 0,
"player_ids": [
"Cx5lvlAM"
]
}
]
}
]
},
"players": [
{
"id": "Cx5lvlAM",
"name": "Rafael",
"list_name": "Rafael",
"number": "23",
"roles": [
{
"title": "Goalkeeper",
"suffix": "(G)"
}
],
"country": "Brazil",
"slug": "rafael",
"age": 37,
"height_cm": 192,
"market_value": 380099,
"average_rating": 6.8,
"rating": {
"value": 8,
"is_best": false
},
"incidents": []
},
{
"id": "nLOOaaTl",
"name": "Pedro Lima",
"number": "32",
"rating": {
"value": 7.8,
"is_best": false
},
"incidents": [
{
"type": "YellowCard",
"minute": "60'",
"reasons": [
"Tripping"
]
}
]
}
],
"groups": [
{
"type": "STARTERS",
"name": "Starting Lineups",
"player_ids": [
"Cx5lvlAM",
"nLOOaaTl"
]
}
],
"coaches": [
{
"id": "hWy8sVW9",
"name": "Dorival Junior",
"country": "Brazil",
"slug": "dorival-junior"
}
],
"substitutions": [
{
"id": "AkY1pAJH",
"player_in_id": "S4KKxXdC",
"player_out_id": "6DGXE64C",
"minute": "46'"
}
],
"aggregated_stats": {
"average_rating": 6.9,
"average_height_cm": 179.7,
"average_age": 29.3,
"sum_market_value": 28609520
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.matchLineupsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.matchLineupsDataDoc | No | ||||
| data.match_id | string | No | j52jHsN8 | |||
| data.source_url | string | No | https://2.ds.lsapp.eu/pq_graphql?_hash=dlie2&eventId=j52jHsN8&projectId=2 | |||
| data.teams | array | No | ||||
| data.teams[].aggregated_stats | flashscore.lineupAggregatedStatsDoc | No | ||||
| data.teams[].aggregated_stats.average_age | number | No | 26.6 | |||
| data.teams[].aggregated_stats.average_height_cm | number | No | 181.1 | |||
| data.teams[].aggregated_stats.average_rating | number | No | 6.7 | |||
| data.teams[].aggregated_stats.sum_market_value | number | No | 47598854 | |||
| data.teams[].average_rating | number | No | 7.1 | |||
| data.teams[].coaches | array | No | ||||
| data.teams[].coaches[].age | number | No | 35 | |||
| data.teams[].coaches[].average_rating | number | No | 7 | |||
| data.teams[].coaches[].country | string | No | Brazil | |||
| data.teams[].coaches[].height_cm | number | No | 189 | |||
| data.teams[].coaches[].id | string | No | x2zyKcHK | |||
| data.teams[].coaches[].list_name | string | No | Tiago Volpi | |||
| data.teams[].coaches[].market_value | number | No | 880751 | |||
| data.teams[].coaches[].name | string | No | Tiago Volpi | |||
| data.teams[].coaches[].number | string | No | 18 | |||
| data.teams[].coaches[].roles | array | No | ||||
| data.teams[].coaches[].roles[].suffix | string | No | (G) | |||
| data.teams[].coaches[].roles[].title | string | No | Goalkeeper | |||
| data.teams[].coaches[].slug | string | No | tiago-volpi | |||
| data.teams[].formation | flashscore.predictedFormationDoc | No | ||||
| data.teams[].formation.lines | array | No | ||||
| data.teams[].formation.lines[].number | integer | No | 1 | |||
| data.teams[].formation.lines[].rows | array | No | ||||
| data.teams[].formation.lines[].rows[].player_ids | array | No | x2zyKcHK | |||
| data.teams[].formation.lines[].rows[].sort_key | integer | No | 0 | |||
| data.teams[].formation.name | string | No | 4-2-3-1 | |||
| data.teams[].groups | array | No | ||||
| data.teams[].groups[].name | string | No | Predicted lineups | |||
| data.teams[].groups[].player_ids | array | No | x2zyKcHK | |||
| data.teams[].groups[].type | string | No | PREDICTED_STARTERS | |||
| data.teams[].name | string | No | Brighton | |||
| data.teams[].participant_id | string | No | 4zJjW8Rb | |||
| data.teams[].players | array | No | ||||
| data.teams[].players[].age | number | No | 37 | |||
| data.teams[].players[].average_rating | number | No | 6.8 | |||
| data.teams[].players[].country | string | No | Brazil | |||
| data.teams[].players[].height_cm | number | No | 192 | |||
| data.teams[].players[].id | string | No | Cx5lvlAM | |||
| data.teams[].players[].incidents | array | No | ||||
| data.teams[].players[].incidents[].hidden | boolean | No | false | |||
| data.teams[].players[].incidents[].minute | string | No | 60' | |||
| data.teams[].players[].incidents[].player_in_id | string | No | S4KKxXdC | |||
| data.teams[].players[].incidents[].reasons | array | No | Tripping | |||
| data.teams[].players[].incidents[].type | string | No | YellowCard | |||
| data.teams[].players[].list_name | string | No | Rafael | |||
| data.teams[].players[].market_value | number | No | 380099 | |||
| data.teams[].players[].name | string | No | Rafael | |||
| data.teams[].players[].number | string | No | 23 | |||
| data.teams[].players[].rating | flashscore.lineupRatingDoc | No | ||||
| data.teams[].players[].rating.is_best | boolean | No | false | |||
| data.teams[].players[].rating.value | number | No | 8 | |||
| data.teams[].players[].roles | array | No | ||||
| data.teams[].players[].roles[].suffix | string | No | (G) | |||
| data.teams[].players[].roles[].title | string | No | Goalkeeper | |||
| data.teams[].players[].slug | string | No | rafael | |||
| data.teams[].side | string | No | home, away | home | ||
| data.teams[].substitutions | array | No | ||||
| data.teams[].substitutions[].id | string | No | AkY1pAJH | |||
| data.teams[].substitutions[].minute | string | No | 46' | |||
| data.teams[].substitutions[].player_in_id | string | No | S4KKxXdC | |||
| data.teams[].substitutions[].player_out_id | string | No | 6DGXE64C | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-lineups?id=j52jHsN8" \
-H "x-api-key: $CRAWLORA_API_KEY"