Docs menu

SofaScore API endpoint

SofaScore event lineups API

Returns one match's starting XI and substitutes per side, with formation. Returns 404 when SofaScore has no lineups for the match. A missing-lineup result may be reused for up to two minutes before checking again.

GETapiKey2 credits/requestSofaScoresofascore.eventLineupsResponseDoc/sofascore/event-lineups

Endpoint facts

Method: GET
API path: /sofascore/event-lineups
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.eventLineupsResponseDoc

SofaScore API Try SofaScore event lineups API in Playground SofaScore API documentation

How this endpoint behaves

Query parameters:

id: required. Numeric SofaScore event (match) id.

Notable response behavior:

Returns 404 when SofaScore has no lineups for the match (not yet announced or not tracked).
A missing-lineup result may be reused for up to two minutes. Newly announced lineups can become visible after that window; upstream failures remain retryable.
An upstream 200 with confirmed=false and explicit empty player arrays on both sides also returns 404. Predicted lineups with players remain valid; malformed or confirmed-empty payloads return 503.
confirmed indicates whether the lineup is the official confirmed lineup rather than a predicted one.
home/away each carry a formation (e.g. 4-3-3) and a players list; substitute marks bench players.

Live monitoring

Monitored request: GET /sofascore/event-lineups?id=14025013
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.36 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/event-lineups?id=14025013
Items in home.players: 20
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 20 checked	Values in the sample
player	20
jersey_number	20	1 to 73, median 11
position	20	M (9), D (6), F (3) and 1 more
substitute	9	true in 9 of 9

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Numeric SofaScore event (match) id	14025013
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/event-lineups?id=14025013" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 14025013,
    "confirmed": true,
    "source_url": "https://api.sofascore.com/api/v1/event/14025013/lineups",
    "fetched_at": "2026-07-08T16:45:00Z",
    "home": {
      "formation": "4-3-3",
      "players": [
        {
          "player": {
            "id": 66101,
            "name": "Alisson",
            "short_name": "Alisson",
            "position": "G",
            "country": "Brazil"
          },
          "jersey_number": "1",
          "position": "G",
          "substitute": false
        }
      ]
    },
    "away": {
      "formation": "4-4-2",
      "players": []
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.eventLineupsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.EventLineupsResponse	No
data.away	object	No		Away side's lineup.
data.away.formation	string	No	4-3-3	Formation, for example 4-3-3.
data.away.players	array	No		Starting players and substitutes.
data.away.players[].jersey_number	string	No		Shirt number worn in this match.
data.away.players[].player	object	No		The player.
data.away.players[].player.country	string	No	Spain	Player's country.
data.away.players[].player.id	integer	No	855833	SofaScore player id. Use it with the player endpoints.
data.away.players[].player.name	string	No	Ferran Torres	Player's full name.
data.away.players[].player.position	string	No	F	Position code, for example G, D, M or F.
data.away.players[].player.short_name	string	No	F. Torres	Shortened name, for example "F. Torres".
data.away.players[].player.slug	string	No	ferran-torres	URL slug of the player on SofaScore.
data.away.players[].position	string	No		Position in this match, for example G, D, M or F.
data.away.players[].substitute	boolean	No		True for a player on the bench.
data.confirmed	boolean	No		True for the official confirmed lineups, false while they are still predicted.
data.event_id	integer	No		SofaScore event id the lineups belong to.
data.fetched_at	string	No		Time the data was fetched, in UTC (RFC 3339).
data.home	object	No		Home side's lineup.
data.home.formation	string	No	4-3-3	Formation, for example 4-3-3.
data.home.players	array	No		Starting players and substitutes.
data.home.players[].jersey_number	string	No		Shirt number worn in this match.
data.home.players[].player	object	No		The player.
data.home.players[].player.country	string	No	Spain	Player's country.
data.home.players[].player.id	integer	No	855833	SofaScore player id. Use it with the player endpoints.
data.home.players[].player.name	string	No	Ferran Torres	Player's full name.
data.home.players[].player.position	string	No	F	Position code, for example G, D, M or F.
data.home.players[].player.short_name	string	No	F. Torres	Shortened name, for example "F. Torres".
data.home.players[].player.slug	string	No	ferran-torres	URL slug of the player on SofaScore.
data.home.players[].position	string	No		Position in this match, for example G, D, M or F.
data.home.players[].substitute	boolean	No		True for a player on the bench.
data.source_url	string	No		SofaScore URL the data was read from.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sofascore/event-lineups?id=14025013" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More SofaScore endpoint docs SofaScore API SofaScore categories for a sport API documentation SofaScore competitions in a category API documentation SofaScore league draft picks API documentation SofaScore league draft API documentation SofaScore esports game detail API documentation SofaScore event at-bat pitches API documentation

Open in Playground Back to group

Docs menu

SofaScore API endpoint

SofaScore event lineups API

GETapiKey2 credits/requestSofaScoresofascore.eventLineupsResponseDoc/sofascore/event-lineups

Endpoint facts

Method: GET
API path: /sofascore/event-lineups
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.eventLineupsResponseDoc

SofaScore API Try SofaScore event lineups API in Playground SofaScore API documentation

How this endpoint behaves

Query parameters:

id: required. Numeric SofaScore event (match) id.

Notable response behavior:

Returns 404 when SofaScore has no lineups for the match (not yet announced or not tracked).
A missing-lineup result may be reused for up to two minutes. Newly announced lineups can become visible after that window; upstream failures remain retryable.
An upstream 200 with confirmed=false and explicit empty player arrays on both sides also returns 404. Predicted lineups with players remain valid; malformed or confirmed-empty payloads return 503.
confirmed indicates whether the lineup is the official confirmed lineup rather than a predicted one.
home/away each carry a formation (e.g. 4-3-3) and a players list; substitute marks bench players.

Live monitoring

Monitored request: GET /sofascore/event-lineups?id=14025013
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.36 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/event-lineups?id=14025013
Items in home.players: 20
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 20 checked	Values in the sample
player	20
jersey_number	20	1 to 73, median 11
position	20	M (9), D (6), F (3) and 1 more
substitute	9	true in 9 of 9

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Numeric SofaScore event (match) id	14025013
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/event-lineups?id=14025013" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 14025013,
    "confirmed": true,
    "source_url": "https://api.sofascore.com/api/v1/event/14025013/lineups",
    "fetched_at": "2026-07-08T16:45:00Z",
    "home": {
      "formation": "4-3-3",
      "players": [
        {
          "player": {
            "id": 66101,
            "name": "Alisson",
            "short_name": "Alisson",
            "position": "G",
            "country": "Brazil"
          },
          "jersey_number": "1",
          "position": "G",
          "substitute": false
        }
      ]
    },
    "away": {
      "formation": "4-4-2",
      "players": []
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.eventLineupsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.EventLineupsResponse	No
data.away	object	No		Away side's lineup.
data.away.formation	string	No	4-3-3	Formation, for example 4-3-3.
data.away.players	array	No		Starting players and substitutes.
data.away.players[].jersey_number	string	No		Shirt number worn in this match.
data.away.players[].player	object	No		The player.
data.away.players[].player.country	string	No	Spain	Player's country.
data.away.players[].player.id	integer	No	855833	SofaScore player id. Use it with the player endpoints.
data.away.players[].player.name	string	No	Ferran Torres	Player's full name.
data.away.players[].player.position	string	No	F	Position code, for example G, D, M or F.
data.away.players[].player.short_name	string	No	F. Torres	Shortened name, for example "F. Torres".
data.away.players[].player.slug	string	No	ferran-torres	URL slug of the player on SofaScore.
data.away.players[].position	string	No		Position in this match, for example G, D, M or F.
data.away.players[].substitute	boolean	No		True for a player on the bench.
data.confirmed	boolean	No		True for the official confirmed lineups, false while they are still predicted.
data.event_id	integer	No		SofaScore event id the lineups belong to.
data.fetched_at	string	No		Time the data was fetched, in UTC (RFC 3339).
data.home	object	No		Home side's lineup.
data.home.formation	string	No	4-3-3	Formation, for example 4-3-3.
data.home.players	array	No		Starting players and substitutes.
data.home.players[].jersey_number	string	No		Shirt number worn in this match.
data.home.players[].player	object	No		The player.
data.home.players[].player.country	string	No	Spain	Player's country.
data.home.players[].player.id	integer	No	855833	SofaScore player id. Use it with the player endpoints.
data.home.players[].player.name	string	No	Ferran Torres	Player's full name.
data.home.players[].player.position	string	No	F	Position code, for example G, D, M or F.
data.home.players[].player.short_name	string	No	F. Torres	Shortened name, for example "F. Torres".
data.home.players[].player.slug	string	No	ferran-torres	URL slug of the player on SofaScore.
data.home.players[].position	string	No		Position in this match, for example G, D, M or F.
data.home.players[].substitute	boolean	No		True for a player on the bench.
data.source_url	string	No		SofaScore URL the data was read from.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sofascore/event-lineups?id=14025013" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

SofaScore event lineups API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

SofaScore event lineups API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related