Skip to main content

Base URL

https://v2.basketball.sportsapipro.com
Finding IDs: Get manager, referee, and venue IDs from match details (/api/match/{matchId}). You can also use /api/match/{matchId}/managers for coach IDs and /api/match/{matchId}/referee for referee IDs.

Manager / Coach Endpoints

Manager Details

GET /api/managers/{managerId}
Returns coach profile: name, nationality, age, current team, and preferred formation/style.
managerId
number
required
Numeric manager ID. Discover from match details or match managers endpoint.

Manager Image

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

Manager Career

GET /api/managers/{managerId}/career
Returns complete coaching career history: teams managed, dates, and win/loss records.

Manager Last Events

GET /api/managers/{managerId}/events/last/{page}
Returns recent games coached, paginated.
page
number
required
Page number (0-indexed).

Manager Next Events

GET /api/managers/{managerId}/events/next/{page}
Returns upcoming games for the coach’s current team.

Manager Tournament Statistics

GET /api/managers/{managerId}/tournament/{tournamentId}/season/{seasonId}/statistics
Returns the coach’s statistics in a specific tournament season: wins, losses, points per game.

Referee Endpoints

Referee Details

GET /api/referee/{refereeId}
Returns referee profile and career summary.
refereeId
number
required
Numeric referee ID. Discover from match details.

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: games officiated, fouls called.

Referee Last Events

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

Referee Next Events

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

Venue / Arena Endpoints

Venue Details

GET /api/venue/{venueId}
Returns arena information: name, city, country, capacity, and location.
venueId
number
required
Numeric venue ID. Discover from match details or team details.

Venue Last Events

GET /api/venue/{venueId}/events/last/{page}
Returns recent games played at the arena.

Venue Next Events

GET /api/venue/{venueId}/events/next/{page}
Returns upcoming games scheduled at the arena.

Example Requests

# Get coach career
curl -X GET "https://v2.basketball.sportsapipro.com/api/managers/12345/career" \
  -H "x-api-key: YOUR_API_KEY"

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