---
title: "SofaScore tournaments scheduled on a date"
method: GET
path: "/sofascore/scheduled-tournaments"
tags: ["SofaScore"]
---

# SofaScore tournaments scheduled on a date

`GET /sofascore/scheduled-tournaments`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/scheduled-tournaments`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `sport` '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', required
- `date` string, required
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreScheduledTournamentsResponseDoc
  - `code` integer
  - `data` SofascoreScheduledTournamentsResponse
    - `count` integer
    - `date` string
    - `fetched_at` string
    - `has_next_page` boolean
    - `page` integer
    - `source_url` string
    - `sport` string
    - `tournaments` SofascoreScheduledTournament[]
      - `category_id` integer
      - `category_name` string
      - `event_count` integer: EventCount is the number of events that start on the requested UTC date.
      - `id` integer
      - `name` string
      - `slug` string
      - `unique_tournament_id` integer
      - `unique_tournament_name` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)