SoccersAPIDocs
DocsReferenceFixtures › Match by ID

GETMatch by ID

One match with teams, league, venue, scores, status and clock.

/v2.2/fixtures/ with t=info

Try it in the interactive referenceAll Fixtures operations

Request

GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=2589310&include=events,stats

Parameters

NameRequiredDescriptionExample
idyesMatch ID.2589310
includenoComma-separated datasets to embed in the response, without spaces. Supported values: events, stats, broadcast, odds_prematch, odds_inplay. See the includes section.events,stats
utcnoUTC offset applied to returned date/time values; time.timezone reports it, for example UTC+4.5. Decimal offsets are accepted and invalid values fall back to UTC.2
langnoLanguage code for localized names, for example en, es, de, fr, it, pt, tr, pl, ko or zh. Verified on country, continent and league catalogue names; match and statistics payloads are not translated.en
odds_formatnoOdds format on odds datasets: decimal (default), fractional or american.decimal

Example response

{
  "data": {
    "id": 2589310,
    "status": 3,
    "status_name": "Finished",
    "status_period": null,
    "pitch": null,
    "referee_id": null,
    "round_id": "216028",
    "round_name": "2",
    "season_id": "21033",
    "season_name": "26/27",
    "stage_id": "3461",
    "stage_name": "Regular Season - Premier League 26/27",
    "group_id": "13583",
    "group_name": "Premier League 26/27",
    "aggregate_id": null,
    "winner_team_id": 20,
    "venue_id": "1166",
    "leg": null,
    "week": "35",
    "deleted": "0",
    "related_id": null,
    "info": null,
    "attendance": null,
    "time": {
      "datetime": "2026-08-30 13:00:00",
      "date": "2026-08-30",
      "time": "13:00:00",
      "minute": 90,
      "timestamp": 1788094800,
      "timezone": "UTC"
    },
    "teams": {
      "home": {
        "id": 20,
        "name": "Chelsea FC",
        "short_code": "CFC",
        "img": "https://cdn.soccersapi.com/images/soccer/teams/80/20.png",
        "form": null,
        "coach_id": 12680,
        "kit_colors": {
          "home_main_color": "#1532c1",
          "home_second_color": "#1532c1",
          "home_number_color": "#f7d444",
          "home_gk_main_color": "#1d5160",
          "home_gk_second_color": "#121212",
          "home_gk_number_color": "#fcfcfc"
        }
      },
      "away": {
        "id": 12,
        "name": "Brighton & Hove Albion",
        "short_code": "BRI",
        "img": "https://cdn.soccersapi.com/images/soccer/teams/80/12.png",
        "form": null,
        "coach_id": 9291,
        "kit_colors": {
          "away_main_color": "#ffffff",
          "away_second_color": "#ffffff",
          "away_number_color": "#306fbe",
          "away_gk_main_color": "#fff200",
          "away_gk_second_color": "#ffe900",
          "away_gk_number_color": "#faf4f4"
        }
      }
    },
    "league": {
      "id": 583,
      "name": "Premier League",
      "type": "Premier League 26/27",
      "country_id": "3",
      "country_name": "England",
      "country_code": "en",
      "country_flag": "https://cdn.soccersapi.com/images/countries/30/en.png"
    },
    "scores": {
      "home_score": "4",
      "away_score": "3",
      "ht_score": "3-1",
      "ft_score": "4-3",
      "et_score": null,
      "ps_score": null
    },
    "standings": {
      "home_position": 8,
      "away_position": 5
    },
    "assistants": {
      "first_assistant_id": null,
      "second_assistant_id": null,
      "fourth_assistant_id": null
    },
    "coverage": {
      "has_lineups": 1,
      "has_tvs": 1,
      "has_standings": 1
    },
    "weather_report": {
      "desc": "cloudy",
      "temp": {
        "celsius": 21.2,
        "fahrenheit": 70.2
      },
      "wind": {
        "kmph": 13.7,
        "miles": 8.51,
        "direction": "SW"
      },
      "humidity_percent": 56,
      "pressure": 1009
    },
    "events": [
      {
        "team_id": 20,
        "type": "corner",
        "period": "1st half",
        "player_id": null,
        "player_name": null,
        "related_player_id": null,
        "related_player_name": null,
        "minute": "4",
        "extra_minute": null,
        "timestamp": null,
        "reason": null,
        "injuried": null,
        "own_goal": false,
        "penalty": false,
        "result": null,
        "info": "1st Corner kick"
      }
    ],
    "stats": [
      {
        "team_id": 20,
        "key_passes": "14",
        "passing_accuracy": 67,
        "fouls": "5",
        "injuries": "2",
        "corners": "4",
        "crosses": "5",
        "crossing_accuracy": 40,
        "offsides": "0",
        "shots_total": 22,
        "shots_on_target": "6",
        "shots_off_target": "11",
        "shots_blocked": "5",
        "possessiontime": 23.4,
        "possessionpercent": 26,
        "yellowcards": "1",
        "yellowredcards": "0",
        "redcards": "0",
        "substitutions": "5",
        "goal_kick": "16",
        "goal_attempts": "10",
        "free_kick": "14",
        "throw_in": "13",
        "ball_safe": "76",
        "goals": 4,
        "penalties": "0",
        "attacks": "58",
        "dangerous_attacks": "23",
        "action_areas": "29.00",
        "xg": "2.96"
      }
    ]
  },
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 1,
    "count": 1,
    "total": 1,
    "msg": ""
  }
}