Mainz schedule & live scores API

Get Mainz fixtures, live scores, odds and results as JSON from Realtime Sports API. The team id is 2950 in soccer/ger.1; filter the Bundesliga events, live and schedule endpoints by it. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.

Team id
2950
Abbreviation
M05
Home venue
MEWA ARENA, Mainz
2026-27 German Bundesliga season
34 games · record 3 won, 1 drawn, 5 lost

Next game: Mainz visit FC Augsburg on Sun, Nov 22, 9:30 AM ET at WWK Arena.

Upcoming Mainz games

Upcoming Mainz games
DateAwayHomeTime / ResultVenue
Sun, Nov 22MainzatFC Augsburg9:30 AM ETWWK Arena · Augsburg
Sat, Nov 281. FC Union BerlinatMainz9:30 AM ETMEWA ARENA · Mainz
Sat, Dec 5MainzatRB Leipzig9:30 AM ETRed Bull Arena · Leipzig
Sun, Dec 13SC FreiburgatMainz9:30 AM ETMEWA ARENA · Mainz
Sat, Dec 19FC CologneatMainz9:30 AM ETMEWA ARENA · Mainz
Fri, Jan 8MainzatBorussia Dortmund2:30 PM ETSignal Iduna Park · Aue

Times are US Eastern; refreshed hourly. Full Mainz schedule with JSON/CSV download

Recent Mainz results

Recent Mainz results
DateAwayHomeTime / ResultVenue
Sat, Nov 7Bayern MunichatMainz2 - 1 FinalMEWA ARENA · Mainz
Fri, Oct 30MainzatSV Elversberg1 - 4 FinalURSAPHARM-Arena an der Kaiserlinde · Spiesen-Elversberg
Sat, Oct 24Werder BremenatMainz3 - 2 FinalMEWA ARENA · Mainz
Sat, Oct 17MainzatSchalke 041 - 0 FinalVeltins Arena · Gelsenkirchen
Sat, Oct 10Bayer LeverkusenatMainz4 - 3 FinalMEWA ARENA · Mainz

Live example: team detail

Request

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/ger.1/teams/2950"

Response captured from live data at 2026-11-21 05:09 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Captured hourly; logos trimmed to one.

Response

{
  "success": true,
  "data": {
    "id": "2950",
    "uid": "s:600~t:2950",
    "slug": "ger.mainz",
    "location": "Mainz",
    "name": "Mainz",
    "abbreviation": "M05",
    "displayName": "Mainz",
    "shortDisplayName": "Mainz",
    "color": "DA0308",
    "alternateColor": "000055",
    "league": {},
    "venue": {
      "id": "4450",
      "name": "MEWA ARENA",
      "city": "Mainz"
    },
    "isActive": true,
    "isAllStar": false,
    "logos": [
      {
        "href": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXQAOWRMQEENcUx1GVgNDARRJCFQ",
        "width": 500,
        "height": 500,
        "alt": "",
        "rel": [
          "full",
          "default"
        ],
        "lastUpdated": "2019-05-08T16:07Z"
      },
      "... 1 more"
    ]
  }
}

Get Mainz scores in code

The events endpoint returns the whole Bundesliga scoreboard, so keep the games where either team id is 2950.

curl + jq

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/ger.1/teams/2950"

# This team's games in the current scoreboard (filter by team id 2950)
curl -s -H "Authorization: Bearer $RSA_API_KEY" "https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/ger.1/events" \
  | jq '.data[] | select(.homeTeam.id == "2950" or .awayTeam.id == "2950") | {name, date, status: .status.detail, home: .homeTeam.score, away: .awayTeam.score}'

JavaScript (fetch)

const TEAM_ID = "2950"; // Mainz
const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/ger.1/events", {
  headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { data } = await res.json();
const games = data.filter((e) => e.homeTeam.id === TEAM_ID || e.awayTeam.id === TEAM_ID);
for (const g of games) {
  console.log(g.shortName, g.status.detail, `${g.awayTeam.score}-${g.homeTeam.score}`);
}

Python (requests)

import os, requests

TEAM_ID = "2950"  # Mainz
res = requests.get(
    "https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/ger.1/events",
    headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
    timeout=10,
)
for g in res.json()["data"]:
    if TEAM_ID in (g["homeTeam"]["id"], g["awayTeam"]["id"]):
        print(g["shortName"], g["status"]["detail"], g["awayTeam"]["score"], g["homeTeam"]["score"])

MCP prompt (Claude, Cursor, ChatGPT)

Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_schedule with sport "soccer" and league "ger.1" for the next 14 days and list the Mainz games (team id 2950) with dates and opponents; then call get_live_events and tell me if they are playing now.

Connect the hosted MCP server first: setup guide.

More endpoints for this team: /sports/soccer/leagues/ger.1/teams/2950/roster, /sports/soccer/leagues/ger.1/news?team=2950. Step-by-step builds: guides.

FAQ

How do I get live Mainz scores in JSON?
Call GET https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/ger.1/events/live with a free API key and keep the games where homeTeam.id or awayTeam.id is "2950". The live endpoint returns the score, period, clock and status for games in progress. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.
Is there a free Mainz API?
Yes. The Free plan of Realtime Sports API is $0 with 1,000 calls in the first 30 days, then 125 calls per month, no card. The same key covers every Bundesliga team and the other leagues.
What is the Mainz team id?
"2950" in league "ger.1" (sport "soccer"). Use it with /sports/soccer/leagues/ger.1/teams/2950 for team details and /sports/soccer/leagues/ger.1/teams/2950/roster for the roster, and to filter events by homeTeam.id or awayTeam.id.
When is the next Mainz game?
Mainz visit FC Augsburg on Sun, Nov 22, 9:30 AM ET at WWK Arena. Times are US Eastern; this page refreshes hourly.
Does the API include Mainz betting odds?
Yes, for upcoming Bundesliga games that have a line: GET /sports/soccer/leagues/ger.1/events/{eventId}/odds returns the spread, moneyline and total from a single source book, and /odds/history returns line moves. It is not a multi-book comparison feed.
Can I get Mainz score alerts pushed to me?
Yes, on paid plans: register a webhook for event.score_change and event.final filtered to league "ger.1", then keep deliveries where data.homeTeam.id or data.awayTeam.id is "2950" (webhooks filter by league, not team). WebSocket works the same way.

All Bundesliga team APIs · Bundesliga API · Free Bundesliga scoreboard widget