Skip to main content
All team endpoints accept an optional ?sport={slug} (default football) and, where relevant, ?tz=±HH:MM.

Team Detail (Full)

GET /api/v1/team/{teamId}?sport=football
Returns the complete team payload — players, matches, table row, totals, injuries, honors, lineups, goal distribution, related teams, venues, manager, market value.
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/team/5xvkjoiyyyix793"
{
  "success": true,
  "team": {
    "id": "5xvkjoiyyyix793",
    "name": "Real Madrid",
    "venue":   { "name": "Santiago Bernabéu Stadium" },
    "manager": { "name": "Carlo Ancelotti" },
    "country": { "name": "Spain" },
    "marketValue": "€ 1.219B",
    "totalPlayers": 40,
    "foundationTime": "1902",
    "slug": "real-madrid"
  }
}

Team Squad

GET /api/v1/team/{teamId}/squad
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/team/5xvkjoiyyyix793/squad"

Team Trophies

GET /api/v1/team/{teamId}/trophies
Returns honor types with per-season items (e.g. Real Madrid → 21 honor types including Champions League, La Liga).

Team Injuries

GET /api/v1/team/{teamId}/injuries
{
  "success": true,
  "injuries": [
    { "player": { "id": "...", "pid": 101330 }, "type": 1, "reason": "Knee injury", "startTime": 1772467200 }
  ]
}

Team Salary

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

Team Matches

GET /api/v1/team/{teamId}/matches?sport=football&tz=00:00

Team Month Matches (with Names)

GET /api/v1/team/{teamId}/month-matches?sport=football&tz=00:00
Like /matches but fully hydrated — returns matches[], teams[], competitions[], and venues[] arrays so you don’t need follow-up calls.

Team Transfers

GET /api/v1/team/{teamId}/transfers
May return an empty payload for smaller teams.
GET /api/v1/team/{teamId}/map
Returns the top 20 globally popular teams (Real Madrid, Barcelona, Bayern Munich, …) — useful for “you may also like” surfaces. Cache TTL: 10 minutes for all team endpoints.
Last modified on June 29, 2026