TheSportsDB
TheSportsDB API provides programmatic access to a free, crowd‑sourced sports database, offering searchable, lookup, listing, filtering, schedule and live‑score endpoints for leagues, teams, players, events, and venues across multiple sports.
Admin: update documentationGET
/lookuphonours.php
Lookup Honours
id ( query , required ) — Unique identifier for the honour.GET
/lookupformerteams.php
Lookup Former Teams
id ( query , required ) — Unique identifier for the player.GET
/lookupmilestones.php
Lookup Milestones
id ( query , required ) — Unique identifier for the player.GET
/searchteams.php
Search Teams
t ( query , required ) — Team's main or alternate name.GET
/searchevents.php
Search Events
e ( query , required ) — Event's title.s ( query ) — Season of the event.d ( query ) — Date of the event.f ( query ) — Filename of the event.GET
/searchplayers.php
Search Players
p ( query , required ) — Player's name.GET
/searchvenues.php
Search Venues
v ( query , required ) — Venue's name.GET
/lookupleague.php
Lookup League
id ( query , required ) — Unique identifier for the league.GET
/lookuptable.php
Lookup Table
l ( query , required ) — Unique identifier for the table.s ( query ) — Season of the table.GET
/lookupteam.php
Lookup Team
id ( query , required ) — Unique identifier for the team.GET
/lookupequipment.php
Lookup Equipment
id ( query , required ) — Unique identifier for the equipment.GET
/lookupplayer.php
Lookup Player
id ( query , required ) — Unique identifier for the player.GET
/lookupcontracts.php
Lookup Contracts
id ( query , required ) — Unique identifier for the player.GET
/lookupevent.php
Lookup Event
id ( query , required ) — Unique identifier for the event.GET
/eventresults.php
Event results
id ( query , required ) — Unique identifier for the event.GET
/lookuplineup.php
Lookup Lineup
id ( query , required ) — Unique identifier for the event.GET
/lookuptimeline.php
Lookup Timeline
id ( query , required ) — Unique identifier for the event.GET
/lookupeventstats.php
Lookup Event Stats
id ( query , required ) — Unique identifier for the event.GET
/lookuptv.php
Lookup TV
id ( query , required ) — Unique identifier for the event.GET
/lookupvenue.php
Lookup Venue
id ( query , required ) — Unique identifier for the venue.GET
/all_sports.php
Get All Sports
GET
/all_countries.php
Get All Countries
GET
/all_leagues.php
Get All Leagues
GET
/search_all_leagues.php
Search All Leagues
s ( query , required ) — Name of the sport to search for leagues.c ( query , required ) — Name of the country to search for leagues.GET
/search_all_seasons.php
Search All Seasons
id ( query , required ) — Unique identifier for the league.poster ( query ) — Whether to include poster images in the response (1 for yes, 0 for no).badge ( query ) — Whether to include badge images in the response (1 for yes, 0 for no).GET
/search_all_teams.php
Search All Teams
l ( query , required ) — Name of the league to search for teams.c ( query ) — Name of the country to search for teams (optional).s ( query ) — Name of the sport to search for teams (optional).GET
/lookup_all_players.php
Lookup All Players
id ( query , required ) — Unique identifier for the team.GET
/eventsnext.php
Get Next Events
id ( query , required ) — Unique identifier for the team.GET
/eventslast.php
Get Last Events
id ( query , required ) — Unique identifier for the team.GET
/eventsnextleague.php
Get Next League Events
id ( query , required ) — Unique identifier for the league.GET
/eventspastleague.php
Get Past League Events
id ( query , required ) — Unique identifier for the league.GET
/eventsday.php
Get Events by Day
d ( query , required ) — Date to search for events (format `YYYY-MM-DD`).s ( query ) — Name of the sport to filter events (optional).l ( query ) — Name of the league to filter events (optional).GET
/eventsseason.php
Get Events by Season
id ( query , required ) — Unique identifier for the league.s ( query , required ) — Name of the season to filter events.GET
/eventstv.php
Get Events by TV
d ( query , required ) — Date to search for events (format `YYYY-MM-DD`).a ( query ) — Name of the country.s ( query ) — Name of the sport to filter events (optional).GET
/eventshighlights.php
Get Event Highlights
d ( query , required ) — Date to search for event highlights (format `YYYY-MM-DD`).l ( query ) — Unique identifier for the league to filter highlights (optional).s ( query ) — Name of the sport to filter highlights (optional).GET
/search/league/{leagueName}
Search sports league
leagueName ( path , required ) — The name of the league to search for.GET
/search/team/{teamName}
Search sports team
teamName ( path , required ) — The name of the team to search for.GET
/search/player/{playerName}
Search sports player
playerName ( path , required ) — The name of the player to search for.GET
/search/event/{eventName}
Search sports event
eventName ( path , required ) — The name of the event to search for.GET
/search/venue/{venueName}
Search sports venue
venueName ( path , required ) — The name of the venue to search for.GET
/lookup/league/{idLeague}
Lookup sports league by ID
idLeague ( path , required ) — The ID of the league to lookup.GET
/lookup/team/{idTeam}
Lookup team by ID
idTeam ( path , required ) — The ID of the team to lookup.GET
/lookup/team_equipment/{idTeam}
Lookup team equipment by ID
idTeam ( path , required ) — The ID of the team to lookup equipment for.GET
/lookup/player/{idPlayer}
Lookup player by ID
idPlayer ( path , required ) — The ID of the player to lookup.GET
/lookup/player_contracts/{idPlayer}
Lookup player contracts.
idPlayer ( path , required ) — The ID of the player to lookup career history for.GET
/lookup/player_honours/{idPlayer}
Lookup player honours.
idPlayer ( path , required ) — The ID of the player to lookup honours for.GET
/lookup/player_milestones/{idPlayer}
Lookup player milestones.
idPlayer ( path , required ) — The ID of the player to lookup milestones for.GET
/lookup/player_teams/{idPlayer}
Lookup player former teams.
idPlayer ( path , required ) — The ID of the player to lookup former teams for.GET
/lookup/event/{idEvent}
Lookup Event by ID
idEvent ( path , required ) — The ID of the event to lookup.GET
/lookup/event_lineup/{idEvent}
Lookup Event Lineup by ID
idEvent ( path , required ) — The ID of the event to lookup lineup for.GET
/lookup/event_results/{idEvent}
Lookup Event Results by ID
idEvent ( path , required ) — The ID of the event to lookup results for.GET
/lookup/event_stats/{idEvent}
Lookup Event Statistics by ID
idEvent ( path , required ) — The ID of the event to lookup statistics for.GET
/lookup/event_timeline/{idEvent}
Lookup Event Timeline by ID
idEvent ( path , required ) — The ID of the event to lookup timeline for.GET
/lookup/event_tv/{idEvent}
Lookup Motorsport Event Broadcast
idEvent ( path , required ) — The ID of the motorsport event to lookup broadcast details for.GET
/lookup/event_highlights/{idEvent}
Lookup Event Highlights
idEvent ( path , required ) — The ID of the event to lookup highlights for.GET
/lookup/venue/{idVenue}
Lookup Venue by ID
idVenue ( path , required ) — The ID of the venue to lookup.GET
/list/teams/{idLeague}
List Teams by League ID
idLeague ( path , required ) — The ID of the league to list teams for.GET
/list/seasons/{idLeague}
List Seasons by League ID
idLeague ( path , required ) — The ID of the league to list seasons for.GET
/list/seasonposters/{idLeague}
List Season Posters by League ID
idLeague ( path , required ) — The ID of the league to list season posters for.GET
/list/players/{idTeam}
List Players by Team ID
idTeam ( path , required ) — The ID of the team to list players for.GET
/filter/tv/day/{date}
Filter TV Events by Date
date ( path , required ) — The date to filter events by (format - YYYY-MM-DD).GET
/filter/tv/country/{country}
Filter TV Events by Country
country ( path , required ) — The country to filter events by.GET
/filter/tv/sport/{sport}
Filter TV Events by Sport
sport ( path , required ) — The sport to filter events by.GET
/filter/tv/channel/{channel}
Filter TV Events by Channel
channel ( path , required ) — The channel to filter events by.GET
/all/countries
Get All Countries
GET
/all/sports
Get All Sports
GET
/all/leagues
Get All Leagues
GET
/schedule/next/league/{idLeague}
Get Next Soccer Events by League
idLeague ( path , required ) — The ID of the league to get the next events for.GET
/schedule/previous/league/{idLeague}
Get Previous Soccer Events by League
idLeague ( path , required ) — The ID of the league to get the previous events for.GET
/schedule/next/team/{idTeam}
Get Next Soccer Events by Team
idTeam ( path , required ) — The ID of the team to get the next events for.GET
/schedule/previous/team/{idTeam}
Get Previous Soccer Events by Team
idTeam ( path , required ) — The ID of the team to get the previous events for.GET
/schedule/next/venue/{idVenue}
Get Next Soccer Events by Venue
idVenue ( path , required ) — The ID of the venue to get the next events for.GET
/schedule/previous/venue/{idVenue}
Get Previous Soccer Events by Venue
idVenue ( path , required ) — The ID of the venue to get the previous events for.GET
/schedule/full/team/{idTeam}
Get Full Soccer Schedule by Team
idTeam ( path , required ) — The ID of the team to get the full schedule for.GET
/schedule/league/{idLeague}/{season}
Get Full Motorsport Schedule by League and Season
idLeague ( path , required ) — The ID of the league to get the full schedule for.season ( path , required ) — The season to get the full schedule for.GET
/livescore/{sport}
Get live scores for a specific sport
sport ( path , required ) — The sport to get live scores for.GET
/livescore/{leagueId}
Get live scores for a specific league by ID
leagueId ( path , required ) — The ID of the sport to get live scores for.GET
/livescore/all
Get all live scores for all sports
78 endpoints auto-detected
Authentication
This API uses an API key, passed in the "X-API-KEY" header. No OAuth required.
curl -X GET \
"https://www.thesportsdb.com/api/v2/json/lookuphonours.php" \
-H "X-API-KEY: YOUR_API_KEY" www.thesportsdb.com · HTTPS only