SofaScore

SofaScore events scheduled in a category on a date

Returns the events (matches) in one category, such as a country, that start on a UTC date, ordered by start time. Get the category id from the categories endpoint (or category_id from scheduled-tournaments). date must be a real calendar date written YYYY-MM-DD and is a UTC day; to cover a local day in another timezone, request the neighbouring dates and filter on start_timestamp. An empty events list is a valid response when the category has no fixtures that day. Returns 404 for an unknown category id.

get/sofascore/scheduled-events

Request

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

Query parameters

category_idstring required

Numeric SofaScore category id from the categories endpoint

datestring required

UTC calendar date, YYYY-MM-DD

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "date": "2026-10-08",
    "events": [
      {
        "away_team": {
          "country": "Spain",
          "id": 2817,
          "name": "FC Barcelona",
          "short_name": "Barcelona",
          "slug": "barcelona"
        },
        "home_team": {
          "country": "Spain",
          "id": 2817,
          "name": "FC Barcelona",
          "short_name": "Barcelona",
          "slug": "barcelona"
        },
        "id": 14025013,
        "start_time": "2025-08-15T19:00:00Z",
        "status": {
          "description": "Ended",
          "type": "finished"
        },
        "tournament": {
          "category": "England",
          "name": "Premier League",
          "slug": "premier-league",
          "unique_tournament_id": 17,
          "unique_tournament_name": "Premier League"
        }
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.