Skip to main content

Base URL

Finding Team IDs: Use /api/search?q=arsenal to find team IDs, or extract them from match details (homeTeam.id, awayTeam.id).
Manager + home venue in one call. GET /api/teams/{teamId} is the single best source for a team’s current manager (name, country, id) and home venue (name, capacity, city) — both arrive as data.team.manager and data.team.venue in the same response. See the World Cup 2026 managers & venues guide for a full example.

Team Profile

Team Details

Returns team metadata: name, short name, country, venue, manager, founded year, and competition info.
number
required
Numeric team ID. Discover via /api/search or match details.
Recorded 24 September 2026 from GET /v2/football/teams/2561 (lists trimmed to 2 items).

Team Squad / Players

Returns the full squad with player details: name, position, nationality, jersey number, age, market value, and contract expiry.
Recorded 24 September 2026 from GET /v2/football/teams/2561/players (lists trimmed to 2 items).

Team Image

Returns the team crest/badge image URL.
Recorded 24 September 2026 from GET /v2/football/teams/2561/image (lists trimmed to 2 items).

Events

Last Events (Paginated)

Returns the team’s most recent completed matches, paginated.
number
required
Page number (0-indexed). Start with 0 for the most recent events.
Recorded 24 September 2026 from GET /v2/football/teams/2561/events/last/0 (lists trimmed to 2 items).

Next Events (Paginated)

Returns upcoming scheduled matches for the team, paginated.
Recorded 24 September 2026 from GET /v2/football/teams/2561/events/next/0 (lists trimmed to 2 items).

Near Events

Returns the closest past and upcoming events around the current date.
Recorded 24 September 2026 from GET /v2/football/teams/2561/near-events (lists trimmed to 2 items).
Returns the team’s most prominent upcoming match (e.g., next league fixture, derby, or cup match).
Recorded 24 September 2026 from GET /v2/football/teams/2561/featured-event (lists trimmed to 2 items).

Statistics

Team Statistics in Tournament Season

Returns detailed team statistics for a specific tournament and season.
string
default:"overall"
Filter by match location: overall, home, or away.
Use /api/tournaments/{id}/seasons to discover valid seasonId values.
Recorded 24 September 2026 from GET /v2/football/teams/2561/tournament/35/season/97464/statistics?type=overall (lists trimmed to 2 items).

Goal Distributions

Returns when goals were scored and conceded, broken down by time intervals (0–15, 16–30, 31–45, 46–60, 61–75, 76–90 minutes).
Recorded 24 September 2026 from GET /v2/football/teams/2561/tournament/35/season/97464/goal-distributions (lists trimmed to 2 items).

Performance / Recent Form

Returns the team’s recent form: last N results, win/draw/loss streak, and performance trend.
Recorded 24 September 2026 from GET /v2/football/teams/2561/performance (lists trimmed to 2 items).

Metadata

Tournaments

Returns all competitions the team participates in (e.g., Premier League, Champions League, FA Cup).
Recorded 24 September 2026 from GET /v2/football/teams/2561/unique-tournaments (lists trimmed to 2 items).

Transfers

Returns the team’s transfer activity: signings, departures, loan deals, and transfer fees.
This is the recommended route for transfer history. For a whole competition at once, use the V1 competition feed: GET https://api.sportsapipro.com/v1/football/competition/{competitionId}/transfers (e.g. competition 73 = Portugal Primeira Liga). The V6 global/competition transfer routes are currently unstable — see V6 Global Transfers.
Recorded 24 September 2026 from GET /v2/football/teams/2561/transfers (lists trimmed to 2 items).

Media

Returns media content associated with the team (photos, videos).
No example: this endpoint returned HTTP 404 for our Bundesliga sample on 24 September 2026. It only returns data when the entity has it (for example knockout draws, penalties or media), so handle an empty or 404 response.

Media Summary

Returns a media summary for the team (highlights, videos) localized by country.
string
default:"GB"
Country code for localized content (e.g., GB, US, DE).
Recorded 24 September 2026 from GET /v2/football/teams/2561/media-summary?country=DE (lists trimmed to 2 items).

Tweets

Returns official tweets from the team’s X/Twitter account.
No example: this endpoint returned HTTP 404 for our Bundesliga sample on 24 September 2026. It only returns data when the entity has it (for example knockout draws, penalties or media), so handle an empty or 404 response.

Available Seasons

Discover which seasons have data available for this team:
Use these endpoints to find valid season IDs before calling season-specific statistics endpoints.

Example Requests

Example responses

Real responses recorded on 24 September 2026 from the Bundesliga (tournament 35, season 97464), match SC Paderborn 07 3-1 TSG Hoffenheim (16434052). Long lists are shortened to the first items; field names and structure are unchanged.
Last modified on September 24, 2026