Endpoint Playground
Returns a page of a team's upcoming or recent fixtures. The `direction` enum accepts `next` and `last`. An empty `events` list is a valid response when there is no fixture on that page.
14 Oct 2026: 30 events; 11 fields had a value in every checked item.
Sample value profiles: start_timestamp: 2026-03-10 to 2026-10-10; start_time: 2026-03-10 to 2026-10-10.
curl 'https://api.crawlora.net/api/v1/sofascore/team-events?id=2817&direction=next' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id | string | Yes | 2817 | Numeric SofaScore team id |
| direction | string | Yes | next | Fixture direction |
| page | integer | No | Zero-based page number |
{
"code": 200,
"msg": "OK",
"data": {
"team_id": 2817,
"direction": "next",
"page": 0,
"has_next_page": true,
"count": 1,
"source_url": "https://api.sofascore.com/api/v1/team/2817/events/next/0",
"fetched_at": "2026-07-08T16:45:00Z",
"events": [
{
"id": 16500000,
"slug": "barcelona-real-madrid",
"start_timestamp": 1757520000,
"start_time": "2026-09-10T19:00:00Z",
"status": {
"code": 0,
"description": "Not started",
"type": "notstarted"
},
"tournament": {
"id": 52,
"name": "LaLiga",
"category": "Spain",
"unique_tournament_id": 8,
"unique_tournament_name": "LaLiga"
},
"home_team": {
"id": 2817,
"name": "FC Barcelona",
"short_name": "Barcelona",
"slug": "barcelona",
"country": "Spain"
},
"away_team": {
"id": 2829,
"name": "Real Madrid",
"short_name": "Real Madrid",
"slug": "real-madrid",
"country": "Spain"
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.