Docs menu

SofaScore API endpoint

SofaScore live events API

Returns currently live events for a sport. The `sport` enum accepts `american-football`, `aussie-rules`, `badminton`, `bandy`, `baseball`, `basketball`, `beach-volley`, `cricket`, `darts`, `esports`, `floorball`, `football`, `futsal`, `handball`, `ice-hockey`, `mma`, `minifootball`, `padel`, `rugby`, `snooker`, `table-tennis`, `tennis`, `volleyball`, and `waterpolo`; the sports endpoint lists them. An empty `events` list is a valid response when nothing is live right now.

GETapiKey1 credit/requestSofaScoresofascore.liveEventsResponseDoc/sofascore/live-events

Endpoint facts

Method: GET
API path: /sofascore/live-events
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.liveEventsResponseDoc

SofaScore API Try SofaScore live events API in Playground SofaScore API documentation

How this endpoint behaves

Returns currently live events for a sport from SofaScore.

Query parameters:

sport: required enum. Allowed values: american-football, aussie-rules, badminton, bandy, baseball, basketball, beach-volley, cricket, darts, esports, floorball, football, futsal, handball, ice-hockey, mma, minifootball, padel, rugby, snooker, table-tennis, tennis, volleyball, waterpolo. The sports endpoint returns the same list with live event counts.

Notable response behavior:

An empty events array is a valid response when nothing is live right now (not an error).
Invalid sport values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /sofascore/live-events?sport=football
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.61 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/live-events?sport=football
Items in events: 87
Fields filled in every checked item: 10

Field	Filled in, of 87 checked	Values in the sample
id	87
slug	87
start_timestamp	87	2026-10-13
start_time	87	2026-10-13
status	87
tournament	87
home_team	87
away_team	87
home_score	87
away_score	87

Request parameters

Parameter	Type	Required	Default	Description	Example
sport	string	Yes		Sport key Allowed values: american-football, aussie-rules, badminton, bandy, baseball, basketball, beach-volley, cricket, darts, esports, floorball, football, futsal, handball, ice-hockey, mma, minifootball, padel, rugby, snooker, table-tennis, tennis, volleyball, waterpolo.	football
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/live-events?sport=football" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "football",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/sport/football/events/live",
    "fetched_at": "2026-07-08T16:45:00Z",
    "events": [
      {
        "id": 16467444,
        "slug": "pfc-cska-ii-sofia-fc-marek-1915-dupnitsa",
        "start_timestamp": 1751980800,
        "start_time": "2026-07-08T12:00:00Z",
        "status": {
          "code": 6,
          "description": "1st half",
          "type": "inprogress"
        },
        "tournament": {
          "id": 1339,
          "name": "Club Friendly Games",
          "category": "World",
          "unique_tournament_id": 853,
          "unique_tournament_name": "Club Friendly Games"
        },
        "home_team": {
          "id": 1,
          "name": "PFC CSKA II Sofia",
          "short_name": "CSKA II Sofia",
          "slug": "pfc-cska-ii-sofia",
          "country": "Bulgaria"
        },
        "away_team": {
          "id": 2,
          "name": "FC Marek 1915 Dupnitsa",
          "short_name": "Marek Dupnitsa",
          "slug": "fc-marek-1915-dupnitsa",
          "country": "Bulgaria"
        },
        "home_score": {
          "current": 0
        },
        "away_score": {
          "current": 1
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.liveEventsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.LiveEventsResponse	No
data.count	integer	No	10	Number of events returned.
data.events	array	No		Matches currently in progress.
data.events[].away_score	object	No		Away side's score, when available.
data.events[].away_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].away_score.period1	integer	No		Score in the first period.
data.events[].away_score.period2	integer	No		Score in the second period.
data.events[].away_team	object	No		Away side.
data.events[].away_team.country	string	No	Spain	Country the team belongs to.
data.events[].away_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].away_team.name	string	No	FC Barcelona	Full team name.
data.events[].away_team.national	boolean	No		True for a national team.
data.events[].away_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].away_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].home_score	object	No		Home side's score, when available.
data.events[].home_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].home_score.period1	integer	No		Score in the first period.
data.events[].home_score.period2	integer	No		Score in the second period.
data.events[].home_team	object	No		Home side.
data.events[].home_team.country	string	No	Spain	Country the team belongs to.
data.events[].home_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].home_team.name	string	No	FC Barcelona	Full team name.
data.events[].home_team.national	boolean	No		True for a national team.
data.events[].home_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].home_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].id	integer	No	14025013	SofaScore event id. Use it with the event endpoints.
data.events[].slug	string	No		URL slug of the match on SofaScore.
data.events[].start_time	string	No	2025-08-15T19:00:00Z	Start time in UTC (RFC 3339).
data.events[].start_timestamp	integer	No		Start time as a Unix timestamp in seconds.
data.events[].status	object	No		Current status of the match.
data.events[].status.code	integer	No		SofaScore's numeric status code, for example 0 for not started and 100 for ended.
data.events[].status.description	string	No	Ended	Status as displayed, for example "Ended".
data.events[].status.type	string	No	finished	Status group, for example `notstarted`, `inprogress` or `finished`.
data.events[].tournament	object	No		Tournament and parent competition the match belongs to.
data.events[].tournament.category	string	No	England	Category the tournament sits under, usually a country or region.
data.events[].tournament.id	integer	No		SofaScore id of the tournament the match is filed under. The seasons, standings and round endpoints take `unique_tournament_id` instead.
data.events[].tournament.name	string	No	Premier League	Tournament name.
data.events[].tournament.slug	string	No	premier-league	URL slug of the tournament on SofaScore.
data.events[].tournament.unique_tournament_id	integer	No	17	Id of the parent competition. This is the tournament id the tournament-seasons, standings and round-events endpoints take.
data.events[].tournament.unique_tournament_name	string	No	Premier League	Name of the parent competition.
data.events[].winner_code	integer	No		Result code: 1 when the home side won, 2 when the away side won, 3 for a draw. Omitted until the match is decided.
data.fetched_at	string	No		Time the data was fetched, in UTC (RFC 3339).
data.source_url	string	No		SofaScore URL the data was read from.
data.sport	string	No	football	Sport the events belong to.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/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/live-events?sport=football" \
  -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 live events API

GETapiKey1 credit/requestSofaScoresofascore.liveEventsResponseDoc/sofascore/live-events

Endpoint facts

Method: GET
API path: /sofascore/live-events
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.liveEventsResponseDoc

SofaScore API Try SofaScore live events API in Playground SofaScore API documentation

How this endpoint behaves

Returns currently live events for a sport from SofaScore.

Query parameters:

sport: required enum. Allowed values: american-football, aussie-rules, badminton, bandy, baseball, basketball, beach-volley, cricket, darts, esports, floorball, football, futsal, handball, ice-hockey, mma, minifootball, padel, rugby, snooker, table-tennis, tennis, volleyball, waterpolo. The sports endpoint returns the same list with live event counts.

Notable response behavior:

An empty events array is a valid response when nothing is live right now (not an error).
Invalid sport values return an invalid-parameter error before upstream IO.

Live monitoring

Monitored request: GET /sofascore/live-events?sport=football
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.61 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/live-events?sport=football
Items in events: 87
Fields filled in every checked item: 10

Field	Filled in, of 87 checked	Values in the sample
id	87
slug	87
start_timestamp	87	2026-10-13
start_time	87	2026-10-13
status	87
tournament	87
home_team	87
away_team	87
home_score	87
away_score	87

Request parameters

Parameter	Type	Required	Default	Description	Example
sport	string	Yes		Sport key Allowed values: american-football, aussie-rules, badminton, bandy, baseball, basketball, beach-volley, cricket, darts, esports, floorball, football, futsal, handball, ice-hockey, mma, minifootball, padel, rugby, snooker, table-tennis, tennis, volleyball, waterpolo.	football
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/live-events?sport=football" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "football",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/sport/football/events/live",
    "fetched_at": "2026-07-08T16:45:00Z",
    "events": [
      {
        "id": 16467444,
        "slug": "pfc-cska-ii-sofia-fc-marek-1915-dupnitsa",
        "start_timestamp": 1751980800,
        "start_time": "2026-07-08T12:00:00Z",
        "status": {
          "code": 6,
          "description": "1st half",
          "type": "inprogress"
        },
        "tournament": {
          "id": 1339,
          "name": "Club Friendly Games",
          "category": "World",
          "unique_tournament_id": 853,
          "unique_tournament_name": "Club Friendly Games"
        },
        "home_team": {
          "id": 1,
          "name": "PFC CSKA II Sofia",
          "short_name": "CSKA II Sofia",
          "slug": "pfc-cska-ii-sofia",
          "country": "Bulgaria"
        },
        "away_team": {
          "id": 2,
          "name": "FC Marek 1915 Dupnitsa",
          "short_name": "Marek Dupnitsa",
          "slug": "fc-marek-1915-dupnitsa",
          "country": "Bulgaria"
        },
        "home_score": {
          "current": 0
        },
        "away_score": {
          "current": 1
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.liveEventsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.LiveEventsResponse	No
data.count	integer	No	10	Number of events returned.
data.events	array	No		Matches currently in progress.
data.events[].away_score	object	No		Away side's score, when available.
data.events[].away_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].away_score.period1	integer	No		Score in the first period.
data.events[].away_score.period2	integer	No		Score in the second period.
data.events[].away_team	object	No		Away side.
data.events[].away_team.country	string	No	Spain	Country the team belongs to.
data.events[].away_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].away_team.name	string	No	FC Barcelona	Full team name.
data.events[].away_team.national	boolean	No		True for a national team.
data.events[].away_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].away_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].home_score	object	No		Home side's score, when available.
data.events[].home_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].home_score.period1	integer	No		Score in the first period.
data.events[].home_score.period2	integer	No		Score in the second period.
data.events[].home_team	object	No		Home side.
data.events[].home_team.country	string	No	Spain	Country the team belongs to.
data.events[].home_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].home_team.name	string	No	FC Barcelona	Full team name.
data.events[].home_team.national	boolean	No		True for a national team.
data.events[].home_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].home_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].id	integer	No	14025013	SofaScore event id. Use it with the event endpoints.
data.events[].slug	string	No		URL slug of the match on SofaScore.
data.events[].start_time	string	No	2025-08-15T19:00:00Z	Start time in UTC (RFC 3339).
data.events[].start_timestamp	integer	No		Start time as a Unix timestamp in seconds.
data.events[].status	object	No		Current status of the match.
data.events[].status.code	integer	No		SofaScore's numeric status code, for example 0 for not started and 100 for ended.
data.events[].status.description	string	No	Ended	Status as displayed, for example "Ended".
data.events[].status.type	string	No	finished	Status group, for example `notstarted`, `inprogress` or `finished`.
data.events[].tournament	object	No		Tournament and parent competition the match belongs to.
data.events[].tournament.category	string	No	England	Category the tournament sits under, usually a country or region.
data.events[].tournament.id	integer	No		SofaScore id of the tournament the match is filed under. The seasons, standings and round endpoints take `unique_tournament_id` instead.
data.events[].tournament.name	string	No	Premier League	Tournament name.
data.events[].tournament.slug	string	No	premier-league	URL slug of the tournament on SofaScore.
data.events[].tournament.unique_tournament_id	integer	No	17	Id of the parent competition. This is the tournament id the tournament-seasons, standings and round-events endpoints take.
data.events[].tournament.unique_tournament_name	string	No	Premier League	Name of the parent competition.
data.events[].winner_code	integer	No		Result code: 1 when the home side won, 2 when the away side won, 3 for a draw. Omitted until the match is decided.
data.fetched_at	string	No		Time the data was fetched, in UTC (RFC 3339).
data.source_url	string	No		SofaScore URL the data was read from.
data.sport	string	No	football	Sport the events belong to.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/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/live-events?sport=football" \
  -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 live events 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 live events 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