Skip to content
GET/rugby/teams

List teams

Teams of a sport that played in the last 120 days, with the leagues they played in. Filter by league_id or by name (q). Soccer teams also carry country, venue and coach from the league squad feeds.

In preview, not in plans yetPay per call without a key: $0.002 in USDC

Parameters

  • league_idinteger · query

    Only teams of this league

  • qstring · query

    Name contains

  • limitinteger · query

    Maximum results (1-100)

    Default: 50
  • offsetinteger · query

    Results to skip

    Default: 0

Response

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

  • dataarray of object
  • 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
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).

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?