---
updatedAt: 2025-08-18T19:38:55.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/widgets/llms.txt
---

# Match List

<b>us.common.MatchList</b> displays a daily list of past, present and future matches. Scores are automatically updated in real-time during live matches.

<Embed url="https://widgets.media.sportradar.com/uscommon/en_us/standalone/us.common.MatchList#border=true&sportId=1" provider="widgets.media.sportradar.com" href="https://widgets.media.sportradar.com/uscommon/en_us/standalone/us.common.MatchList#border=true&sportId=1" typeOfEmbed="iframe" height="400px" width="100%" iframe="true" title="undefined" />

This widget uses local storage for persisting end-user selection (date, live, show/hide odds). The widget displays date/time in the end user's local timezone (based on operating system settings).

### Parameters

<table class="table-striped">
<thead>
  <tr>
    <th>Name</th>
    <th>Type</th>
    <th colspan="5">Description</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>props</code></td>
    <td>object</td>
    <td colspan="5">properties</td>
  </tr>
  <tr>
    <td rowspan="14"></td>
    <td rowspan="14"></td>
    <td><b>Name</b></td>
    <td><b>Type</b></td>
    <td><b>Argument</b></td>
    <td><b>Default</b></td>
    <td><b>Description</b></td>
  </tr>
  <tr>
    <td><code>matchId</code></td>
    <td>number</td>
    <td>optional</td>
    <td></td>
    <td>Match ID</td>
  </tr>
  <tr>
    <td><code>dayOffset</code></td>
    <td>number</td>
    <td>optional</td>
    <td>0</td>
    <td>Day offset from the current date. Default value is <code>0</code> (current date).</td>
  </tr>
  <tr>
    <td><code>sportId</code></td>
    <td>number</td>
    <td>optional</td>
    <td>1</td>
    <td>Sport ID. <code>1</code> (Soccer), <code>2</code> (Basketball), <code>3</code> (Baseball), <code>4</code> (Ice Hockey), <code>9</code> (Golf), <code>16</code> (American Football).</td>
  </tr>
  <tr>
    <td><code>isLive</code></td>
    <td>boolean</td>
    <td>optional</td>
    <td>false</td>
    <td>Displays only live matches when set to <code>true</code>.</td>
  </tr>
  <tr>
    <td><code>showOdds</code></td>
    <td>boolean</td>
    <td>optional</td>
    <td>false</td>
    <td>When set to <code>true</code> includes odds data for each match.</td>
  </tr>
  <tr>
    <td><code>disableOdds</code></td>
    <td>boolean</td>
    <td>optional</td>
    <td>false</td>
    <td>When set to <code>true</code> disables the odds button in the right corner.</td>
  </tr>
  <tr>
    <td><code>onItemClick</code></td>
    <td>function</td>
    <td>optional</td>
    <td></td>
    <td>Function/Event handler, emits <code>matchId</code> on click or touch.</td>
  </tr>
  <tr>
    <td><code>filterUtIds</code></td>
    <td>string</td>
    <td>optional</td>
    <td></td>
    <td>Comma-separated unique tournament IDs. When set, only matches within specified unique tournaments will be listed.</td>
  </tr>
  <tr>
    <td><code>filterRcIds</code></td>
    <td>string</td>
    <td>optional</td>
    <td></td>
    <td>Comma-separated real category IDs. When set, only matches within specified real categories will be listed.</td>
  </tr>
  <tr>
    <td><code>favoriteTournaments</code></td>
    <td>string</td>
    <td>optional</td>
    <td></td>
    <td>Comma-separated unique tournament IDs. When set, tournaments with a specified unique ID will be added to the top of the match list.</td>
  </tr>
  <tr>
    <td><code>oddsDeeplinkLabels</code></td>
    <td>object</td>
    <td>optional</td>
    <td></td>
    <td>An object of deeplinking labels.</td>
  </tr>
  <tr>
    <td><code>deeplinkParams</code></td>
    <td>object</td>
    <td>optional</td>
    <td></td>
    <td>An object of deeplinking parameters.</td>
  </tr>
</tbody>
</table>

### Examples

```html HTML/Declarative
<div class="sr-widget" data-sr-widget="us.common.matchList" data-sr-sport-id="1"></div>
<script type="application/javascript" src="https://widgets.media.sportradar.com/YOUR_CLIENT_ALIAS/widgetloader" data-sr-language="en_us" async></script>

```

```javascript JS/Programmatic
<script>
    (function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
    g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
    )})(window,document,"script","https://widgets.media.sportradar.com/YOUR_CLIENT_ALIAS/widgetloader","SIR", {
        language: 'en_us'
    });
    SIR('addWidget', '#sr-widget', 'us.common.matchList', {sportId: 1});
</script>
<div id="sr-widget"></div>

```

```javascript JS/Example using Event Handler
<script>
    (function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
    g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
    )})(window,document,"script","https://widgets.media.sportradar.com/YOUR_CLIENT_ALIAS/widgetloader","SIR", {
        language: 'en_us'
    });
    SIR('addWidget', '#sr-widget', 'us.common.matchList', {sportId: 1, onItemClick: function(type, obj){alert('matchId: ' + obj.matchId);}});
</script>
<div id="sr-widget"></div>

```