Live Match Stats - AnySport

Given a match_id, returns the match’s complete event stream (every call returns a full snapshot of all events so far for the entire match, not an incremental update), current technical statistics (11 items such as corners/free kicks/yellow and red cards), and the latest event frame’s status. Suitable for building a “live text commentary” style match progress display. On each poll, simply replace your local state entirely with the latest response — no need to stitch together increments on the client side. Both status and events[].type are open-ended English codes that may continue to expand — when parsing, gracefully degrade unknown values to a generic event rather than throwing an error. Relationship to Live Score: endpoint 14 provides only the score and phase, while this endpoint provides the specific “what happened.”

Endpoint

GET /v1/soccer/matches/{match_id}/situation

Parameters

Parameter	Location	Required	Description
`match_id`	path	Yes	Match ID (`as_` id, consistent with /matches)
`lang`	query	No	`en` / `zh-CN`; invalid values silently fall back to the default language — see `GET /languages` (19) for available values

Returns 404 (NOT_FOUND) when no match-events data exists for this match.

Response fields (data: object)

Field	Type	Description
`match_id`	string	Match ID (`as_` prefix, the same ID used across referenced endpoints)
`status`	string	The English code of the latest event frame (snake_case, e.g. `full_time`/`home_corner`): home-team events get a `home_` prefix, away-team events get an `away_` prefix, neutral/global events have no prefix (home/away pairs share the same meaning, e.g. `home_corner`/`away_corner`); to determine the match has ended, use `full_time`/`extra_time_full_time`, or `phase` from livescore. Values may expand over time, so tolerate unknown codes; some events may omit this field, so clients must handle that gracefully
`status_label`	string	Localized text for the `status` code (returned per `lang`, e.g. for `lang=zh-CN` it would be `全场结束`); the original `status` code is unchanged, sent when `lang` is a non-default language and localized text exists for that value
`minute`	int	Current minute (same convention as livescore)
`ball_xy`	string	Current possession/ball position coordinates, `x,y` normalized decimals (relative to the home team’s attacking direction); absent when not provided
`events[]`	array	Full event snapshot (each response covers all events for the entire match so far)
`events[].seq`	int	In-match sequence number (starting from 1, roughly chronological)
`events[].minute`	int	Time the event occurred (integer minute, same type as the top-level `minute`). Includes continuous counting through extra time (`121` = 120+1’); summary-type events are `0`
`events[].type`	string	Type enum (7 values): `goal` / `yellow_card` / `red_card` / `corner` / `penalty` / `substitution` / `event`
`events[].type_label`	string	Localized text for the event type (returned per `lang`, e.g. for `lang=zh-CN` it would be `进球`); the original `type` code is unchanged, sent when `lang` is a non-default language and localized text exists for that value
`events[].team`	string	`home`/`away`; absent for neutral events
`events[].text`	string	Textual description of the event (English), prefixed with the minute and the in-match occurrence count
`stats`	object	Full-match technical statistics. Keys are stat abbreviations, values are `[home, away]` number pairs (e.g. `"c":[8,2]` = corners: home 8, away 2); absent when not provided
`stat_labels`	object	Mapping of `stats` keys → localized labels (returned per `lang`, e.g. for `lang=zh-CN` it would be `{"c":"角球"}`); includes only keys that have localized text; the original `stats` keys are unchanged, sent when `lang` is a non-default language and localized text exists for that key
`updated_at`	string	Update time, UTC ISO-8601 (with `Z`)

*_label convention: status / events[].type / stats keys all retain their original code/key values, with parallel localized labels status_label / events[].type_label / stat_labels added alongside (stat_labels is an object containing only the keys that have localized text); sent when lang is a non-default language and localized text exists for the corresponding value. Event text (text), team names, and league names are not yet localized by lang.

Enum reference

status English codes

status sends an English code (snake_case, underscore-joined English wording):

Home-team events get a home_ prefix
Away-team events get an away_ prefix
Neutral/global events have no prefix (home/away pairs share the same meaning, e.g. home_corner/away_corner)
status is the event code of the latest frame.

status is an open enum: values may expand over time, and some events may omit this field; downstream consumers should degrade gracefully to a generic event when encountering an unknown code or a missing field.

Neutral / global statuses

Value (code)	Meaning
`danger`	Dangerous attack (Danger)
`goal`	Goal
`corner`	Corner
`yellow_card`	Yellow card
`dangerous_free_kick`	Dangerous free kick
`kick_off`	Kickoff
`half_time`	Half-time break
`second_half_start`	Second half starts
`full_time`	End of regular full time
`extra_time_kick_off`	Extra-time kickoff
`extra_time_half_time`	Extra-time half-time
`extra_time_second_half`	Extra-time second half
`extra_time_full_time`	End of extra time
`penalty_shootout`	Penalty shootout
`penalty_missed`	Penalty missed (official name “Penalty missed,” most often seen in a shootout context)
`injury`	Injury stoppage
`injury_time`	Stoppage/injury time
`match_info`	Match info
`offside`	Offside
`zone_throw_in`	Zone throw-in
`substitution`	Substitution
`var_review`	VAR review in progress
`var_red_card`	VAR red card review
`var_goal`	VAR goal review
`var_penalty`	VAR penalty review

Home-team events home_*

Value (code)	Meaning
`home_penalty_shootout_scored`	Home team scored in the penalty shootout
`home_penalty_shootout_missed`	Home team missed in the penalty shootout
`home_penalty_shootout_pending`	Home team pending their shootout kick
`home_dangerous_attack`	Home team dangerous attack
`home_attack`	Home team attack
`home_possession`	Home team possession
`home_goal`	Home team goal
`home_corner`	Home team corner
`home_yellow_card`	Home team yellow card
`home_red_card`	Home team red card
`home_goal_kick`	Home team goal kick
`home_penalty_awarded`	Home team awarded a penalty
`home_direct_free_kick`	Home team direct free kick
`home_free_kick`	Home team regular free kick
`home_shot_on_target`	Home team shot on target
`home_shot_off_target`	Home team shot off target
`home_substitution`	Home team substitution
`home_kick_off`	Home team kickoff
`home_second_half_kick_off`	Home team second-half kickoff
`home_penalty_shootout`	Home team penalty shootout
`home_penalty_missed`	Home team penalty missed
`home_throw_in`	Home team throw-in
`home_injury`	Home team injury stoppage
`home_injury_time`	Home team stoppage/injury time
`home_offside`	Home team offside
`home_zone_throw_in`	Home team zone throw-in
`home_dangerous_attack_with_ball`	Home team dangerous attack with the ball
`home_attack_with_ball`	Home team attack with the ball
`home_safe_possession`	Home team safe possession with the ball
`home_var_review`	Home team VAR review in progress
`home_var_red_card`	Home team VAR red card review
`home_var_goal`	Home team VAR goal review
`home_var_penalty`	Home team VAR penalty review
`home_corner_top`	Home team corner (top side)
`home_corner_bottom`	Home team corner (bottom side)
`home_free_kick_zone_1`~`home_free_kick_zone_6`	Home team free kick zone (6 zones)

Away-team events away_* The away team has the corresponding away_* codes, paired with the same meaning as the home-team events — e.g. home_attack paired with away_attack represents the away team attacking. Free-kick zone codes The free-kick zone codes are the sole exception to the home/away “same-meaning pair” rule: Home team: home_free_kick_zone_1 ~ home_free_kick_zone_6 (zones 1–6); Away team: away_free_kick_zone_7 ~ away_free_kick_zone_12 (zones 7–12; the away team uses independent numbering, not a mirror of the home team’s zones).

phase

Reference for determining match end, unique to livescore, 4 values:

Value	Meaning
`regular`	Regular play in progress (default value. Ordinary attack/defense frames during extra time are also classified as `regular`; to determine “whether currently in extra time,” using `minute > 90` is more reliable)
`extra_time`	Extra-time boundary events (frames for extra-time kickoff / extra-time half-time break / extra-time second-half start, i.e. `extra_time_kick_off`/`extra_time_half_time`/`extra_time_second_half`)
`penalty`	Penalty shootout (frames for shootout start, scored/missed penalties, pending kicks, etc.)
`finished`	Match ended (regular end `full_time` or extra-time end `extra_time_full_time`)

events[].type

Event types are categorized by keyword matches against the text field (type is derived server-side from the text), matched in priority order from top to bottom:

Value	Matched keyword	Meaning (categories covered)
`goal`	text contains “goal”	Goal (including own goals, penalty goals)
`yellow_card`	text contains “yellow”	Yellow card (including extra-time yellow card `Yellow Card ET`)
`red_card`	text contains “red”	Red card
`corner`	text contains “corner”	Corner, corner-count markers (Race to N Corners)
`penalty`	text contains “penalty”	Penalty missed, penalty shootout start, penalty shootout scored
`substitution`	text contains “substitution”	Substitution
`event`	everything else	Shots on/off target, assists, offside, phase score markers, time-interval markers, penalty shootout results, etc.

Goal method suffix

Goal text may have a - {method} suffix, which can be omitted.

Value	Meaning
`Shot`	Shot
`Header`	Header
`Penalty`	Penalty
`Free Kick`	Free kick
`Own Goal`	Own goal

The (Assist: …) assist suffix can also be omitted.

stats key dictionary

11 fixed keys, always returned; the value for each key is a [home, away] two-element array

Value (key)	Meaning (official name)
`a`	Goals (Goal, = current score, including extra time)
`h1`	First-half goals (1st Half)
`c`	Corners (Corner)
`f`	Free kicks (Free Kick, not a foul count)
`t`	Throw-ins (Throw In)
`g`	Goal kicks (Goal Kick)
`y`	Yellow cards (Yellow Card)
`r`	Red cards (Red Card)
`p`	Penalties (Penalty)
`o`	Offsides (Offside)
`s`	Substitutions (Substitution)

Request example

GET /v1/soccer/matches/as_3b37c382f39a4235aa93705f053b2da4/situation

Response example

HTTP 200, 88 total events, minute always an integer; excerpt

{
  "success": true,
  "data": {
    "match_id": "as_3b37c382f39a4235aa93705f053b2da4",
    "status": "extra_time_full_time",
    "minute": 120,
    "events": [
      {
        "seq": 1,
        "minute": 1,
        "type": "event",
        "team": "away",
        "text": "1' - 1st Shot Off Target - (Switzerland)"
      },
      {
        "seq": 2,
        "minute": 7,
        "type": "event",
        "team": "away",
        "text": "7' - 2nd Shot Off Target - (Switzerland)"
      },
      {
        "seq": 3,
        "minute": 9,
        "type": "corner",
        "team": "home",
        "text": "9' - 1st Corner - (Argentina)"
      },
      {
        "seq": 87,
        "minute": 123,
        "type": "event",
        "team": "away",
        "text": "120+3' - 7th Offside - (Switzerland)"
      },
      {
        "seq": 88,
        "minute": 120,
        "type": "event",
        "text": "Score After Extra Time - 3-1"
      }
    ],
    "stats": {
      "c": "",
      "f": "",
      "o": "",
      "p": "",
      "r": "",
      "t": "",
      "y": "",
      "s": "",
      "g": "",
      "a": "",
      "h1": ""
    },
    "updated_at": "2026-07-12T03:45:50Z"
  },
  "meta": {
    "timestamp": "2026-07-17T05:16:34.398572300Z"
  },
  "traceId": "ac2290f7-eacd-4825-ba47-aab52ba7f1ba"
}

​Endpoint

​Parameters

​Response fields (data: object)

​Enum reference

​status English codes

​phase

​events[].type

​Goal method suffix

​stats key dictionary

​Request example

​Response example

Endpoint

Parameters

Response fields (data: object)

Enum reference

status English codes

phase

events[].type

Goal method suffix

stats key dictionary

Request example

Response example