Skip to content
GET/baseball/teams/{id}

Get a team

Soccer teams matched to a Wikidata club also have coach: the current head coach (Wikidata P286: the statement with a start date and no end), the appointment date and the won, drawn and lost count of the team's matches we hold since then (friendlies left out), record_from (the first of those matches) and record_complete (false when our match history of the team starts after the appointment, so the record covers only part of the tenure), with the attribution (Wikidata, CC0) in data and meta. coach_name stays the provider's. Soccer teams also have squad_value_eur: the current squad's summed market value (the data provider player profiles), over players_with_value of squad_players; league-wide in /soccer/leagues/{id}/market-values. The coach with the previous coach and previous club: /soccer/teams/{id}/coach. Every team with a rated result also has rating: its Elo-style rating from our stored results (docs/ratings.md) with rank of of among the active teams of its league, peak, matches_rated, rated_from (provisional below 10 matches) and history, its last 10 rated matches; the lists are /{sport}/ratings.

In the plans that cover this sportPay per call without a key: $0.005 in USDC

Parameters

  • idinteger · pathrequired

    Team ID

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • abbreviationstring
  • attributionstring
  • coachobject

    Coach: the current head coach from Wikidata (soccer; only on /teams/{id}), with the attribution.

  • appointedstring

    YYYY-MM-DD

  • drawninteger
  • lostinteger
  • namestring
  • playedinteger

    with appointed only

  • previous_clubobject
  • previous_coachobject

    The team's coach before this one and this coach's own team before (a club or national team), from Wikidata; absent when not known.

  • record_completeboolean

    false: our history starts after the appointment, record partial

  • record_fromstring

    first match counted, YYYY-MM-DD

  • rolestring

    e.g. caretaker

  • sourcestring

    Wikidata, or the data provider (name only)

  • updated_atstring
  • wikidata_idstring
  • woninteger
  • coach_idinteger
  • coach_namestring
  • countrystring
  • foundedstring
  • idinteger
  • is_nationalboolean
  • is_womenboolean
  • league_idsarray of integer

    leagues played in during the last 120 days

  • logo_urlstring

    LogoURL: the team's logo on this API (image licence not included).

  • namestring
  • players_with_valueinteger
  • profileobject

    Profile: soccer profile sections as sent (transfers, trophies, sidelined, detailed_stats); only on /teams/{id}.

  • ratingobject

    Rating: the team's Elo-style rating with its rank in its league and its last 10 rated matches (only on /teams/{id}; docs/ratings.md).

  • historyarray of object

    /teams/{id}: the last 10 rated matches, latest first

  • last_match_datestring
  • league_idinteger
  • league_namestring
  • matches_ratedinteger
  • ofinteger
  • peaknumber
  • provisionalboolean
  • rankinteger
  • rated_fromstring
  • ratingnumber
  • team_idinteger
  • team_namestring
  • updated_atstring
  • sportstring
  • squad_playersinteger
  • squad_value_eurinteger

    Squad market value (soccer, only on /teams/{id}): the sum of the current squad's market values, over players_with_value of squad_players.

  • updated_atstring
  • venue_addressstring
  • venue_capacityinteger
  • venue_citystring
  • venue_idinteger
  • venue_namestring
  • venue_surfacestring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?