---
title: "Flashscore competitions by sport and date"
method: GET
path: "/flashscore/competitions"
tags: ["Flashscore"]
---

# Flashscore competitions by sport and date

`GET /flashscore/competitions`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/flashscore/competitions`
- Auth: API key in header `x-api-key`

Discovers competitions present in a selected sport's score feed, including the provider competition id, label, region, canonical path, and event count. This is the active feed-date inventory, not an archive of inactive or historical seasons.

## Query parameters

- `sport` 'football' | 'tennis' | 'basketball' | 'hockey' | 'golf' | 'formula-1' | 'baseball' | 'snooker' | 'american-football' | 'aussie-rules' | 'badminton' | 'bandy' | 'beach-soccer' | 'beach-volleyball' | 'boxing' | 'cricket' | 'cycling' | 'darts' | 'esports' | 'field-hockey' | 'floorball' | 'futsal' | 'handball' | 'horse-racing' | 'kabaddi' | 'mma' | 'motorsport' | 'netball' | 'pesapallo' | 'rugby-league' | 'rugby-union' | 'table-tennis' | 'volleyball' | 'water-polo' | 'winter-sports' | 'moto-racing' | 'ski-jumping' | 'alpine-skiing' | 'cross-country-skiing' | 'biathlon', required
- `day_offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FlashscoreCompetitionsResponseDoc
  - `code` integer
  - `data` FlashscoreCompetitionsDataDoc
    - `competitions` FlashscoreCompetitionDoc[]
      - `event_count` integer
      - `id` string
      - `name` string
      - `path` string
      - `region` string
    - `day_offset` integer
    - `source_url` string
    - `sport` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/028417aa35bb?raw)