---
title: "Get running ML:BB matches"
method: GET
path: "/mlbb/matches/running"
tags: ["Mobile Legends: Bang Bang matches"]
---

# Get running ML:BB matches

`GET /mlbb/matches/running`

List running Mobile Legends: Bang Bang matches
> ℹ️  
> 
> This endpoint is available to all customers

## Query parameters

- `filter` FilterOverMLBBMatches
  - `begin_at` string[]
  - `detailed_stats` boolean — Whether the match offers full stats
  - `draw` boolean — Whether result of the match is a draw
  - `end_at` string[]
  - `finished` boolean
  - `forfeit` boolean — Whether match was forfeited
  - `future` boolean — `true` for future matches only, `false` for past matches only. Filtering is done on the `begin_at` value, so matches with `running` status will not appear if `true`.
  - `id` integer[]
  - `league_id` integer[]
  - `match_type` string[]
  - `modified_at` string[]
  - `name` string[]
  - `not_started` boolean
  - `number_of_games` integer[]
  - `opponent_id` union[] — A Team or a Player (id or slug). You can use`filter[winner_type]=Team` or `filter[winner_type]=Player` to focus on teams or players.
    - union
      - integer — The ID of the team.
      - string
      - integer — ID of the player
      - string — Unique, human-readable identifier for the player. `id` and `slug` can be used interchangeably throughout the API.
  - `opponents_filled` boolean — Whether a match has opponents filled i.e. opponents are not TBD.
  - `past` boolean
  - `running` boolean
  - `scheduled_at` string[]
  - `serie_id` integer[]
  - `slug` string[]
  - `status` string[]
  - `tournament_id` integer[]
  - `unscheduled` boolean
  - `videogame` union[]
    - union — A videogame ID or slug
      - 1 | 3 | 4 | 14 | 20 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 — A videogame ID
      - 'cod-mw' | 'cs-go' | 'dota-2' | 'e-basketball' | 'e-cricket' | 'e-hockey' | 'e-soccer' | 'e-tennis' | 'fifa' | 'kog' | 'league-of-legends' | 'lol-wild-rift' | 'mlbb' | 'ow' | 'pubg' | 'r6-siege' | 'rl' | 'starcraft-2' | 'starcraft-brood-war' | 'valorant' — A videogame slug
  - `videogame_title` union[] — A videogame title id or slug. Only for `/csgo/*`, `/codmw/*`, `/fifa/*` and `/ow/*` endpoints
    - union
      - integer
      - string
  - `videogame_version` union[] — Filter by the names of videogame versions, all versions using `filter[videogame_version]=all`, or by the latest version using `filter[videogame_version]=latest` Only for `valorant/*` and `/lol/*` endpoints.
    - union
      - string
      - 'all'
      - 'latest'
  - `winner_id` union[]
    - union
      - integer — ID of the player
      - integer — The ID of the team.
  - `winner_type` string[]
- `range` RangeOverMLBBMatches
  - `begin_at` string[]
  - `detailed_stats` boolean[]
  - `draw` boolean[]
  - `end_at` string[]
  - `forfeit` boolean[]
  - `id` integer[]
  - `match_type` string[]
  - `modified_at` string[]
  - `name` string[]
  - `number_of_games` integer[]
  - `scheduled_at` string[]
  - `slug` string[]
  - `status` string[]
  - `tournament_id` integer[]
  - `winner_id` union[]
    - union
      - integer — ID of the player
      - integer — The ID of the team.
  - `winner_type` string[]
- `sort` string[]
- `search` SearchOverMLBBMatches
  - `match_type` 'all_games_played' | 'best_of' | 'custom' | 'first_to' | 'ow_best_of' | 'red_bull_home_ground'
  - `name` string
  - `slug` string
  - `status` 'canceled' | 'finished' | 'not_started' | 'postponed' | 'running'
  - `winner_type` 'Player' | 'Team'
- `page` union
  - integer
  - object
    - `number` integer
    - `size` integer
- `per_page` integer

## Response `200`

A list of Mobile Legends: Bang Bang matches

- object[]
  - `begin_at` string, date-time, nullable, required
  - `detailed_stats` boolean, required — Whether the match offers full stats
  - `draw` boolean, required — Whether result of the match is a draw
  - `end_at` string, date-time, nullable, required
  - `forfeit` boolean, required — Whether match was forfeited
  - `game_advantage` integer, nullable, required — ID of the opponent with a game advantage
  - `games` object[], required
    - `begin_at` string, date-time, nullable, required — The game begin time, UTC. `null` when the game status is `not_started`
    - `complete` boolean, required — Whether When `true`, the game statistics are complete and will not be updated again
    - `detailed_stats` boolean, required — Whether historical data is available for the game
    - `end_at` string, date-time, nullable, required — The game end time, UTC. `null` when the game status is not `finished`
    - `finished` boolean, required — Whether the game is finished
    - `forfeit` boolean, required — Whether the game has been forfeited
    - `id` union, required — ID of the game. IDs are video game-specific, ie. a Valorant game and an Overwatch game can have the same game ID.
      - integer — LoL game ID
      - integer — Counter-Strike game ID
      - integer
      - integer
      - integer
      - integer
    - `length` integer, nullable, required — Duration of the game in seconds. `null` when the game status is not `finished`
    - `match_id` integer, required
    - `position` integer, required — Game position in the match. Starts at 1
    - `status` 'finished' | 'not_played' | 'not_started' | 'running', required — The game status
    - `winner` object, required
      - `id` union, required
        - integer — ID of the player
        - integer — The ID of the team.
      - `type` 'Player' | 'Team', nullable, required
    - `winner_type` 'Player' | 'Team', nullable, required
  - `id` integer, required
  - `league` object, required
    - `id` integer, required
    - `image_url` string, uri, nullable, required
    - `modified_at` string, date-time, required
    - `name` string, required
    - `slug` string, required
    - `url` string, uri, nullable, required
  - `league_id` integer, required
  - `live` object, required
    - `opens_at` string, date-time, nullable, required
    - `supported` boolean, required — Whether live is supported
    - `url` string, uri, nullable, required
  - `low_latency_feed` object
    - `opens_at` string, date-time, nullable, required
    - `supported` boolean, required — Whether low latency feed is supported
    - `url` string, uri, nullable, required
  - `map_picks` object[], nullable — **Only applies to Valorant matches. The field will not be present on other video games matches.** Map picks, `null` when map picks data is unavailable. **Important:** `map_picks` field is only present in the response for subscribers of Valorant Historical plan.
    - `id` integer, required — ID of the map
    - `image_url` string, uri, required — URL to an image of the map
    - `name` string, required — Name of the map
    - `picking_team_id` integer, nullable, required — ID of the team that picked the map
    - `slug` string, required — Human-readable identifier of the map
    - `videogame_versions` string[], required — Array of of video game versions (ie. patches) for this resource
  - `match_type` 'all_games_played' | 'best_of' | 'custom' | 'first_to' | 'ow_best_of' | 'red_bull_home_ground', required
  - `modified_at` string, date-time, required
  - `name` string, required
  - `number_of_games` integer, required — Number of games
  - `opponents` object[], required
    - `opponent` union, required
      - object
        - `active` boolean, required — Whether player is active
        - `age` number, nullable, required — Age of the player, `null` if unknown. When `birthday` is `null`, `age` is an approxiamation. Read more about [players' age](/docs/about-players-age) **Note**: This field is only present for users running the Historical plan or above.
        - `birthday` string, nullable, required — Birth day of the player, `YYYY-MM-DD` format. `null` if unknown. **Note**: This field is only present for users running the Historical plan or above.
        - `first_name` string, nullable, required — First name of the player. `null` if unknown
        - `id` integer, required — ID of the player
        - `image_url` string, uri, nullable, required — URL to the photo of the player. `null` if not available.
        - `last_name` string, nullable, required — Last name of the player. `null` if unknown
        - `modified_at` string, date-time, required
        - `name` string, required — Professional name of the player
        - `nationality` string, nullable, required — Country code matching the nationality of the player according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the `XK` code is used for Kosovo. `null` if unknown
        - `role` string, nullable, required — Role/position of the player. Field value varies depending on the video game.`null` if unknown. **Note**: role is only available for DotA 2, League of Legends, and Overwatch players. `null` for other video games.
        - `slug` string, nullable, required — Unique, human-readable identifier for the player. `id` and `slug` can be used interchangeably throughout the API.
      - object
        - `acronym` string, nullable, required
        - `dark_mode_image_url` string, uri, nullable, required — URL of the team logo
        - `id` integer, required — The ID of the team.
        - `image_url` string, uri, nullable, required — URL of the team logo
        - `location` string, nullable, required — The team's organization location
        - `modified_at` string, date-time, required
        - `name` string, required — The name of the team.
        - `slug` string, nullable, required
    - `type` 'Player' | 'Team', required
  - `original_scheduled_at` string, date-time, nullable, required
  - `rescheduled` boolean, nullable, required — Whether match has been rescheduled
  - `results` union[], required
    - union
      - object
        - `score` integer, required
        - `team_id` integer, required — The ID of the team.
      - object
        - `player_id` integer, required — ID of the player
        - `score` integer, required
  - `scheduled_at` string, date-time, nullable, required
  - `serie` object, required
    - `begin_at` string, date-time, nullable, required
    - `end_at` string, date-time, nullable, required
    - `full_name` string, required
    - `id` integer, required
    - `league_id` integer, required
    - `modified_at` string, date-time, required
    - `name` string, nullable, required
    - `season` string, nullable, required
    - `slug` string, required
    - `winner_id` union, required
      - integer — ID of the player
      - integer — The ID of the team.
    - `winner_type` 'Player' | 'Team', nullable, required
    - `year` integer, nullable, required
  - `serie_id` integer, required
  - `slug` string, nullable, required
  - `status` 'canceled' | 'finished' | 'not_started' | 'postponed' | 'running', required
  - `streams_list` object[], required
    - `embed_url` string, uri, nullable, required — URL to embed in an iframe.
    - `language` 'aa' | 'ab' | 'ae' | 'af' | 'ak' | 'am' | 'an' | 'ar' | 'as' | 'av' | 'ay' | 'az' | 'ba' | 'be' | 'bg' | 'bh' | 'bi' | 'bm' | 'bn' | 'bo' | 'br' | 'bs' | 'ca' | 'ce' | 'ch' | 'co' | 'cr' | 'cs' | 'cu' | 'cv' | 'cy' | 'da' | 'de' | 'dv' | 'dz' | 'ee' | 'el' | 'en' | 'eo' | 'es' | 'et' | 'eu' | 'fa' | 'ff' | 'fi' | 'fj' | 'fo' | 'fr' | 'fy' | 'ga' | 'gd' | 'gl' | 'gn' | 'gu' | 'gv' | 'ha' | 'he' | 'hi' | 'ho' | 'hr' | 'ht' | 'hu' | 'hy' | 'hz' | 'ia' | 'id' | 'ie' | 'ig' | 'ii' | 'ik' | 'io' | 'is' | 'it' | 'iu' | 'ja' | 'jv' | 'ka' | 'kg' | 'ki' | 'kj' | 'kk' | 'kl' | 'km' | 'kn' | 'ko' | 'kr' | 'ks' | 'ku' | 'kv' | 'kw' | 'ky' | 'la' | 'lb' | 'lg' | 'li' | 'ln' | 'lo' | 'lt' | 'lu' | 'lv' | 'mg' | 'mh' | 'mi' | 'mk' | 'ml' | 'mn' | 'mr' | 'ms' | 'mt' | 'my' | 'na' | 'nb' | 'nd' | 'ne' | 'ng' | 'nl' | 'nn' | 'no' | 'nr' | 'nv' | 'ny' | 'oc' | 'oj' | 'om' | 'or' | 'os' | 'pa' | 'pi' | 'pl' | 'ps' | 'pt' | 'qu' | 'rm' | 'rn' | 'ro' | 'ru' | 'rw' | 'sa' | 'sc' | 'sd' | 'se' | 'sg' | 'si' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sq' | 'sr' | 'ss' | 'st' | 'su' | 'sv' | 'sw' | 'ta' | 'te' | 'tg' | 'th' | 'ti' | 'tk' | 'tl' | 'tn' | 'to' | 'tr' | 'ts' | 'tt' | 'tw' | 'ty' | 'ug' | 'uk' | 'ur' | 'uz' | 've' | 'vi' | 'vo' | 'wa' | 'wo' | 'xh' | 'yi' | 'yo' | 'za' | 'zh' | 'zu', required — Language alpha-2 code according to ISO 649-1 standard.
    - `main` boolean, required — Whether it is the main stream. Main stream is always official.
    - `official` boolean, required — Whether it is an official broadcast.
    - `raw_url` string, uri, required — URL to the stream on host website.
  - `tournament` object, required
    - `begin_at` string, date-time, nullable, required
    - `country` string, nullable, required — Country code matching the location of the tournament according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the XK code is used for Kosovo. null if unknown
    - `detailed_stats` boolean, required — Whether the tournament is expected to have detailed statistics available
    - `end_at` string, date-time, nullable, required
    - `has_bracket` boolean, required — Whether the tournament has a bracket
    - `id` integer, required
    - `league_id` integer, required
    - `live_supported` boolean, required — Whether live is supported
    - `modified_at` string, date-time, required
    - `name` string, required
    - `prizepool` string, nullable, required
    - `region` 'AF' | 'ASIA' | 'EEU' | 'ME' | 'NA' | 'OCE' | 'SA' | 'WEU', nullable, required — Region acronym for the location of the tournament.
    - `serie_id` integer, required
    - `slug` string, required
    - `tier` 'a' | 'b' | 'c' | 'd' | 's' | 'unranked', nullable, required — The tier of the tournament, ranging from 'S' to 'Unranked'. Ranking 'S' > 'A' > 'B' > 'C' > 'D' > 'Unranked'
    - `type` 'offline' | 'online' | 'online/offline', nullable, required — Location type for a tournament
    - `winner_id` union, required
      - integer — ID of the player
      - integer — The ID of the team.
    - `winner_type` 'Player' | 'Team', nullable, required
  - `tournament_id` integer, required
  - `videogame` [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object], required
  - `videogame_title` object, nullable, required
    - `id` integer, required
    - `name` string, required
    - `slug` string, required
    - `videogame_id` 1 | 3 | 4 | 14 | 20 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36, required — A videogame ID
  - `videogame_version` object, nullable, required
    - `current` boolean, required — Whether this videogame version is current
    - `name` string, required
  - `winner` union, required
    - object
      - `active` boolean, required — Whether player is active
      - `age` number, nullable, required — Age of the player, `null` if unknown. When `birthday` is `null`, `age` is an approxiamation. Read more about [players' age](/docs/about-players-age) **Note**: This field is only present for users running the Historical plan or above.
      - `birthday` string, nullable, required — Birth day of the player, `YYYY-MM-DD` format. `null` if unknown. **Note**: This field is only present for users running the Historical plan or above.
      - `first_name` string, nullable, required — First name of the player. `null` if unknown
      - `id` integer, required — ID of the player
      - `image_url` string, uri, nullable, required — URL to the photo of the player. `null` if not available.
      - `last_name` string, nullable, required — Last name of the player. `null` if unknown
      - `modified_at` string, date-time, required
      - `name` string, required — Professional name of the player
      - `nationality` string, nullable, required — Country code matching the nationality of the player according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the `XK` code is used for Kosovo. `null` if unknown
      - `role` string, nullable, required — Role/position of the player. Field value varies depending on the video game.`null` if unknown. **Note**: role is only available for DotA 2, League of Legends, and Overwatch players. `null` for other video games.
      - `slug` string, nullable, required — Unique, human-readable identifier for the player. `id` and `slug` can be used interchangeably throughout the API.
    - object
      - `acronym` string, nullable, required
      - `dark_mode_image_url` string, uri, nullable, required — URL of the team logo
      - `id` integer, required — The ID of the team.
      - `image_url` string, uri, nullable, required — URL of the team logo
      - `location` string, nullable, required — The team's organization location
      - `modified_at` string, date-time, required
      - `name` string, required — The name of the team.
      - `slug` string, nullable, required
  - `winner_id` union, required
    - integer — ID of the player
    - integer — The ID of the team.
  - `winner_type` 'Player' | 'Team', required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/pandascore/apis/all-videogames.md) · [All operations](https://skmtc.net/pandascore/apis/all-videogames/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandascore/all-videogames/versions/3bf456812994/schema)