Teams

Team info, upcoming and finished matches, and team-targeted bookmaker offers

Team Info

GET /api/v1/team/{teamId}

Returns sport, category, venue, manager, and league memberships.

{
  "generatedAt": "2026-06-11 13:16:31",
  "team": {
    "sport_id": 1,
    "sport_name": "Football",
    "category_name": "Spain",
    "category_slug": "spain",
    "name": "Real Madrid",
    "slug": "real-madrid",
    "abbr": "MAD",
    "city": "Madrid",
    "venue": "Santiago Bernabeu",
    "manager": "Arbeloa, Alvaro",
    "leagues": [
      { "id": 2, "name": "La Liga", "slug": "primera-division", "abbr": "LaLiga" }
    ]
  }
}

Take homeTeamId / awayTeamId from any match list, then call this endpoint for team-page metadata.

Cache TTL: 10 minutes.

---

Team Matches

GET /api/v1/team/{teamId}/matches

Param	Default	Description
leagueId	(all)	Filter to a specific league
upcomingLimit	5	Max upcoming matches
finishedLimit	10	Max finished matches

{
  "teamId": 88,
  "upcoming": [
    {
      "id": 9817629,
      "md": "2026-08-16 18:00:00+00",
      "ht": "Chapecoense",
      "at": "Bahia",
      "hscore": null,
      "ascore": null,
      "matchstatus": 1,
      "league_id": 21,
      "league_name": "Serie A"
    }
  ],
  "finished": [
    {
      "id": 9523180,
      "md": "2026-05-28 22:30:00+00",
      "ht": "Bahia",
      "at": "Fortaleza EC",
      "hscore": 2,
      "ascore": 1,
      "matchstatus": 8,
      "league_id": 21,
      "league_name": "Serie A"
    }
  ]
}

upcoming filters matchstatus < 8; finished filters matchstatus >= 8.

Cache TTL: 5 minutes.

---

Team Offers

GET /api/v1/team/{teamId}/offers

Bookmaker special offers and welcome bonuses relevant to a team — ideal for monetization slots on team pages.

{
  "specialOffers": [
    {
      "bookmaker": { "id": 126, "name": "bet365", "rating": 4.9, "primary_color": "#126d50" },
      "type": "existing customer",
      "exclusive": 0
    }
  ],
  "welcomeBonuses": [
    {
      "bookmaker": { "id": 126, "name": "bet365", "rating": 4.9 },
      "type": "welcome bonus",
      "bonus_amount": "100%",
      "max_amount": "$30"
    }
  ]
}

Cache TTL: 1 hour.

---

Example

curl -H "x-api-key: YOUR_API_KEY" \
  "https://v4.football.sportsapipro.com/api/v1/team/1"