Endpoint Playground
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.
14 Oct 2026: 27 events; 8 fields had a value in every checked item.
Sample value profiles: start_timestamp: 2026-10-13; start_time: 2026-10-13.
curl 'https://api.crawlora.net/api/v1/sofascore/scheduled-events?category_id=13&date=2026-10-08' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| category_id | string | Yes | 13 | Numeric SofaScore category id from the categories endpoint |
| date | string | Yes | 2026-10-08 | UTC calendar date, YYYY-MM-DD |
{
"code": 200,
"msg": "OK",
"data": {
"category_id": 13,
"date": "2026-10-08",
"count": 1,
"source_url": "https://api.sofascore.com/api/v1/category/13/scheduled-events/2026-10-08",
"fetched_at": "2026-10-07T14:00:00Z",
"events": [
{
"id": 15237995,
"slug": "sao-paulo-cruzeiro",
"start_timestamp": 1791419400,
"start_time": "2026-10-08T00:30:00Z",
"status": {
"code": 0,
"description": "Not started",
"type": "notstarted"
},
"tournament": {
"id": 83,
"name": "Campeonato Brasileiro Série A",
"category": "Brazil",
"unique_tournament_id": 325,
"unique_tournament_name": "Campeonato Brasileiro Série A"
},
"home_team": {
"id": 1954,
"name": "Cruzeiro",
"short_name": "Cruzeiro",
"slug": "cruzeiro",
"country": "Brazil"
},
"away_team": {
"id": 1981,
"name": "São Paulo",
"short_name": "São Paulo",
"slug": "sao-paulo",
"country": "Brazil"
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.