---
title: "Flashscore season calendar"
method: GET
path: "/flashscore/calendar"
tags: ["Flashscore"]
---

# Flashscore season calendar

`GET /flashscore/calendar`

## Request

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

Returns public tournament calendar entries for the current season, sorted by start date, with date ranges, UTC start and end times, host country, winners and winner paths when decided, and competition paths.

## Query parameters

- `category` 'tennis-atp' | 'tennis-wta' | 'golf-pga' | 'golf-dp-world' | 'badminton-bwf' | 'motorsport-f1', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FlashscoreCalendarResponseDoc
  - `code` integer
  - `data` FlashscoreCalendarDataDoc
    - `category` FlashscoreCalendarCategoryDoc
      - `key` string
      - `name` string
      - `path` string
      - `sport` string
    - `events` FlashscoreCalendarEventDoc[]
      - `country` string
      - `date` string
      - `end_time` string
      - `month` string
      - `name` string
      - `path` string
      - `start_time` string
      - `winner` string
      - `winner_path` string
    - `source_url` string
    - `year` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)