APIHub
Back to Explore

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.

Sports & Fitness
apiKeyHeader
HTTPS
CORS: Yes
Description enriched
Visit official documentation

Latency

575ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/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