Mainz schedule & live scores API

Upcoming Mainz games

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

Recent Mainz results

Live example: team detail

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

{
  "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": null,
    "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 -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}'

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}`);
}

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"])

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.

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 host Bayer Leverkusen on Sat, Oct 10, 9:30 AM ET at MEWA 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.