Skip to main content

Base URL

https://v2.football.sportsapipro.com
Finding IDs: Get manager, referee, and venue IDs from match details (/api/match/{matchId}). The response includes referee.id, venue.id, and manager data. You can also use /api/match/{matchId}/managers for manager IDs.

Manager Endpoints

Manager Details

GET /api/managers/{managerId}
Returns manager profile: name, nationality, age, date of birth, current team, and preferred formation.
managerId
number
required
Numeric manager ID (e.g., 793451). Discover from match details or match managers endpoint.

Manager Image

GET /api/managers/{managerId}/image
Returns the manager’s profile photo URL.

Manager Career

GET /api/managers/{managerId}/career
Returns complete managerial career history: clubs managed, dates, win/loss/draw records, and trophies.

Manager Last Events

GET /api/managers/{managerId}/events/last/{page}
Returns recent matches managed, paginated with results and scores.
page
number
required
Page number (0-indexed).

Manager Next Events

GET /api/managers/{managerId}/events/next/{page}
Returns upcoming matches for the manager’s current team, paginated.

Manager Tournament Statistics

GET /api/managers/{managerId}/tournament/{tournamentId}/season/{seasonId}/statistics
Returns the manager’s statistics in a specific tournament season: wins, draws, losses, points per game.
The manager must have been active in the specified tournament/season. Returns 404 otherwise.

Referee Endpoints

Referee Details

GET /api/referee/{refereeId}
Returns referee profile: name, nationality, age, and career stats summary.
refereeId
number
required
Numeric referee ID. Discover from match details (/api/match/{matchId}).

Referee Image

GET /api/referee/{refereeId}/image
Returns the referee’s profile photo URL.

Referee Tournament Statistics

GET /api/referee/{refereeId}/tournament/{tournamentId}/season/{seasonId}/statistics
Returns referee statistics for a specific tournament season: matches officiated, cards given, penalties awarded.

Referee Last Events

GET /api/referee/{refereeId}/events/last/{page}
Returns recent matches officiated by the referee, paginated.

Referee Next Events

GET /api/referee/{refereeId}/events/next/{page}
Returns upcoming matches assigned to the referee, paginated.

Venue Endpoints

Venue Details

GET /api/venue/{venueId}
Returns venue information: name, city, country, capacity, surface type, coordinates, and photo.
venueId
number
required
Numeric venue ID (e.g., 624 for Emirates Stadium). Discover from match details (/api/match/{matchId}) or team details.

Venue Last Events

GET /api/venue/{venueId}/events/last/{page}
Returns recent matches played at the venue, paginated.

Venue Next Events

GET /api/venue/{venueId}/events/next/{page}
Returns upcoming matches scheduled at the venue, paginated.

Example Requests

# Get manager career
curl -X GET "https://v2.football.sportsapipro.com/api/managers/793451/career" \
  -H "x-api-key: YOUR_API_KEY"

# Get venue details
curl -X GET "https://v2.football.sportsapipro.com/api/venue/624" \
  -H "x-api-key: YOUR_API_KEY"