SofaScore matches at a venue API

Endpoint facts

Method

GET

API path

/sofascore/venue-events

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.venueEventsResponseDoc

How this endpoint behaves

Returns one page (up to 30) of the matches played or scheduled at a venue, as match summaries with teams, status, score, competition and start time.

Query parameters:

• id: required. Numeric SofaScore venue id, e.g. 624 for the Emirates Stadium.
• direction: required enum. Allowed values: next (upcoming matches), last (finished matches; page 0 holds the most recent 30 and higher pages go further back). Matches inside a page are in chronological order.
• sport: optional enum for the venue-wide list. Allowed values: all, american-football, aussie-rules, badminton, bandy, baseball, basketball, beach-volley, cricket, darts, esports, floorball, football, futsal, handball, ice-hockey, mma, minifootball, padel, rugby, snooker, table-tennis, tennis, volleyball, waterpolo. Defaults to all. Use a key listed in the venue's sports (from sofascore/venue); a sport the venue never hosted returns 404. Cannot be combined with tournament and season.
• page: optional integer, 0 or more. Zero-based page number. Defaults to 0.
• tournament and season: optional, only together. Numeric unique-tournament id and season id; restrict the list to that competition season's matches at the venue (the Premier League 2026/27 at the Emirates Stadium is tournament=17&season=96668).

Notable response behavior:

• Two upstream lists back this endpoint: the venue-wide list (/venue/{id}/events/{sport}/{direction}/{page}, sport from the venue or all) and the season-scoped list (/unique-tournament/{t}/season/{s}/venue/{id}/events/{direction}/{page}). Both use zero-based pages and report has_next_page.
• Hidden venues (hidden true in sofascore/venue; every NBA arena) have no venue-wide list: both directions and every sport answer 404, while the season-scoped list works. Use sofascore/tournament-venues to get the venues and hidden flags of a season.
• SofaScore answers 404 for an unknown venue, a hidden venue on the venue-wide route, a sport the venue never hosted, a direction with no matches (for example next for a venue with no fixtures) and a page past the last one. The cases cannot be told apart, so all are reported as one 404; follow has_next_page to avoid walking past the end. A 200 with no events is treated as an upstream error.
• sport is echoed (all by default) for the venue-wide list and omitted for the season-scoped list, where tournament_id and season_id are echoed instead.

Example response (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "venue_id": 624,
    "direction": "last",
    "sport": "all",
    "page": 1,
    "has_next_page": true,
    "count": 30,
    "source_url": "https://api.sofascore.com/api/v1/venue/624/events/all/last/1",
    "fetched_at": "2026-10-07T14:00:00Z",
    "events": [
      {
        "id": 12436489,
        "slug": "arsenal-nottingham-forest",
        "start_timestamp": 1732374000,
        "start_time": "2024-11-23T15:00:00Z",
        "status": { "code": 100, "description": "Ended", "type": "finished" },
        "tournament": { "id": 1, "name": "Premier League", "slug": "premier-league", "category": "England", "unique_tournament_id": 17, "unique_tournament_name": "Premier League" },
        "home_team": { "id": 42, "name": "Arsenal", "short_name": "Arsenal", "slug": "arsenal" },
        "away_team": { "id": 14, "name": "Nottingham Forest", "short_name": "Forest", "slug": "nottingham-forest" },
        "home_score": { "current": 3 },
        "away_score": { "current": 0 }
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/venue-events?direction=last&id=624&sport=football

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

1.27 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/venue-events?direction=last&id=624&sport=football

Items in events

30

Fields filled in every checked item

11

Shared guides

Related