Docs menu

SofaScore API endpoint

SofaScore Scheduled Tournaments API

Returns one page of the tournaments that have fixtures on a UTC date for a sport, each with the number of events starting that UTC day. This lists competitions, not matches: use scheduled-events with a tournament's `category_id` for the matches, or its `unique_tournament_id` with the tournament-seasons and round endpoints. `date` must be a real calendar date written `YYYY-MM-DD`. Pages are one-based; follow `has_next_page`. 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`. An empty `tournaments` list is a valid response for a date with no fixtures or a page past the last one.

GETapiKey1 credit/requestSofaScoresofascore.scheduledTournamentsResponseDoc/sofascore/scheduled-tournaments

Endpoint facts

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

SofaScore API Try SofaScore Scheduled Tournaments API in Playground SofaScore API documentation

How this endpoint behaves

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.
date: required. UTC calendar date written YYYY-MM-DD. Impossible dates (2026-02-30), other formats, and extra text are rejected before any upstream request.
page: optional integer, 1 to 100. One-based page number; defaults to 1. Follow has_next_page to read the next page (football has more than one page on a busy day).

Notable response behavior:

Each entry is a season-scoped tournament (id, for example a league group or stage) with its parent competition in unique_tournament_id. A few entries have no parent competition, in which case unique_tournament_id is omitted.
event_count counts events whose UTC start date is the requested date; it is 0 when the tournament's events fall on a neighbouring UTC day.
An empty tournaments array with has_next_page: false is a valid response for a date with no fixtures or a page past the last one.

Live monitoring

Monitored request: GET /sofascore/scheduled-tournaments?date=2026-10-08&sport=football
Checks passed, 7 days to 14 Oct 2026: 99.7%
Median response time: 1.26 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/scheduled-tournaments?date=2026-10-13&sport=football
Items in tournaments: 100
Fields filled in every checked item: 6
Fields empty in some or all items: 2

Field	Filled in, of 100 checked	Values in the sample
id	100
name	100	“UEFA Champions League” and 97 other values
slug	100
unique_tournament_id	99
unique_tournament_name	99	“UEFA Champions League” and 80 other values
category_id	100
category_name	100	“Europe” and 41 other values
event_count	100	0 to 14, median 0

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
date	string	Yes		UTC calendar date, YYYY-MM-DD	2026-10-08
page	integer	No	1	One-based page number; defaults to 1 Minimum: 1. Maximum: 100.	1
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/scheduled-tournaments?sport=football&date=2026-10-08&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "football",
    "date": "2026-10-08",
    "page": 1,
    "has_next_page": true,
    "count": 100,
    "source_url": "https://api.sofascore.com/api/v1/sport/football/scheduled-tournaments/2026-10-08/page/1",
    "fetched_at": "2026-10-07T14:00:00Z",
    "tournaments": [
      {
        "id": 83,
        "name": "Campeonato Brasileiro Série A",
        "slug": "brasileirao-serie-a",
        "unique_tournament_id": 325,
        "unique_tournament_name": "Campeonato Brasileiro Série A",
        "category_id": 13,
        "category_name": "Brazil",
        "event_count": 3
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.scheduledTournamentsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.ScheduledTournamentsResponse	No
data.count	integer	No
data.date	string	No	2026-10-08
data.fetched_at	string	No
data.has_next_page	boolean	No
data.page	integer	No	1
data.source_url	string	No
data.sport	string	No	football
data.tournaments	array	No
data.tournaments[].category_id	integer	No	13
data.tournaments[].category_name	string	No	Brazil
data.tournaments[].event_count	integer	No	3	EventCount is the number of events that start on the requested UTC date.
data.tournaments[].id	integer	No	83
data.tournaments[].name	string	No	Campeonato Brasileiro Série A
data.tournaments[].slug	string	No
data.tournaments[].unique_tournament_id	integer	No	325
data.tournaments[].unique_tournament_name	string	No
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/scheduled-tournaments?sport=football&date=2026-10-08&page=1" \
  -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 Scheduled Tournaments API

GETapiKey1 credit/requestSofaScoresofascore.scheduledTournamentsResponseDoc/sofascore/scheduled-tournaments

Endpoint facts

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

SofaScore API Try SofaScore Scheduled Tournaments API in Playground SofaScore API documentation

How this endpoint behaves

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.
date: required. UTC calendar date written YYYY-MM-DD. Impossible dates (2026-02-30), other formats, and extra text are rejected before any upstream request.
page: optional integer, 1 to 100. One-based page number; defaults to 1. Follow has_next_page to read the next page (football has more than one page on a busy day).

Notable response behavior:

Each entry is a season-scoped tournament (id, for example a league group or stage) with its parent competition in unique_tournament_id. A few entries have no parent competition, in which case unique_tournament_id is omitted.
event_count counts events whose UTC start date is the requested date; it is 0 when the tournament's events fall on a neighbouring UTC day.
An empty tournaments array with has_next_page: false is a valid response for a date with no fixtures or a page past the last one.

Live monitoring

Monitored request: GET /sofascore/scheduled-tournaments?date=2026-10-08&sport=football
Checks passed, 7 days to 14 Oct 2026: 99.7%
Median response time: 1.26 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/scheduled-tournaments?date=2026-10-13&sport=football
Items in tournaments: 100
Fields filled in every checked item: 6
Fields empty in some or all items: 2

Field	Filled in, of 100 checked	Values in the sample
id	100
name	100	“UEFA Champions League” and 97 other values
slug	100
unique_tournament_id	99
unique_tournament_name	99	“UEFA Champions League” and 80 other values
category_id	100
category_name	100	“Europe” and 41 other values
event_count	100	0 to 14, median 0

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
date	string	Yes		UTC calendar date, YYYY-MM-DD	2026-10-08
page	integer	No	1	One-based page number; defaults to 1 Minimum: 1. Maximum: 100.	1
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/scheduled-tournaments?sport=football&date=2026-10-08&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "football",
    "date": "2026-10-08",
    "page": 1,
    "has_next_page": true,
    "count": 100,
    "source_url": "https://api.sofascore.com/api/v1/sport/football/scheduled-tournaments/2026-10-08/page/1",
    "fetched_at": "2026-10-07T14:00:00Z",
    "tournaments": [
      {
        "id": 83,
        "name": "Campeonato Brasileiro Série A",
        "slug": "brasileirao-serie-a",
        "unique_tournament_id": 325,
        "unique_tournament_name": "Campeonato Brasileiro Série A",
        "category_id": 13,
        "category_name": "Brazil",
        "event_count": 3
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.scheduledTournamentsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.ScheduledTournamentsResponse	No
data.count	integer	No
data.date	string	No	2026-10-08
data.fetched_at	string	No
data.has_next_page	boolean	No
data.page	integer	No	1
data.source_url	string	No
data.sport	string	No	football
data.tournaments	array	No
data.tournaments[].category_id	integer	No	13
data.tournaments[].category_name	string	No	Brazil
data.tournaments[].event_count	integer	No	3	EventCount is the number of events that start on the requested UTC date.
data.tournaments[].id	integer	No	83
data.tournaments[].name	string	No	Campeonato Brasileiro Série A
data.tournaments[].slug	string	No
data.tournaments[].unique_tournament_id	integer	No	325
data.tournaments[].unique_tournament_name	string	No
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/scheduled-tournaments?sport=football&date=2026-10-08&page=1" \
  -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 Scheduled Tournaments 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 Scheduled Tournaments 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