Skip to content
Get a key
API reference / Soccer
GET/american-football/teams/{id}/briefing

Team briefing (all sports; tennis: player)

Insights plan feature (403 FEATURE_NOT_IN_PLAN without it). A team's current state from stored results and tables: last-5 form, streaks (overall, home, away), season home and away record, table place, gaps and zone in its current league, last and next match, injuries for the next match, coach_change (soccer: a head coach appointed in the last 45 days), suspended_out and one_booking_from_ban (soccer: the league's card rules, next league match, complete cards only). Every statement is also a sentence (lang=de, es, it, fr). Facts only. format=md returns Markdown.

Insights planPay per call without a key: $0.02 in USDC

Parameters

  • idinteger · pathrequired

    Team ID

  • langstring · query

    Language of sentences and names: de, es, it, fr

  • formatstring · query

    md for Markdown

Response

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

  • dataobject
  • completenessobject
  • as_ofstring
  • history_fromstring
  • results_completeboolean
  • congestionobject

    fixture load: games in the last 7 and 14 days, rest days before the next match

  • games_last_14dinteger
  • games_last_7dinteger
  • last_match_datestring
  • next_match_datestring
  • rest_daysinteger
  • factsarray of object
  • based_onarray of integer
  • history_fromstring
  • importanceinteger
  • incompleteboolean

    a match without a result cuts it: no sentence

  • opponentobject
  • player_idinteger
  • sincestring
  • teamobject
  • team_idinteger

    Flat fields for consumers that do not read values: the team's and player's id, the fact's main number, the day a run or "first since" reaches back to, and the start of our data (no claim reaches further).

  • textstring
  • typestring
  • valueinteger
  • valuesobject
  • formarray of object
  • datestring
  • decided_on_penaltiesboolean
  • league_namestring
  • match_idinteger
  • opponentobject
  • resultstring

    W, D, L; "?" for a match without a result

  • scorestring
  • venuestring
  • injuriesarray of object
  • availabilitystring

    to_miss or questionable

  • lineupsinteger
  • playerstring
  • player_idinteger
  • reasonstring
  • season_goalsinteger

    Why the player matters (filled from our data, soccer only).

  • startsinteger

    starts in the team's last Lineups confirmed lineups

  • team_idinteger
  • top_scorerboolean

    the team's top scorer (ties count)

  • last_matchobject
  • away_teamobject
  • datestring
  • decided_on_penaltiesboolean
  • home_teamobject
  • league_namestring
  • match_idinteger
  • scorestring

    home-away

  • league_namestring

    the league the table and records are about

  • next_matchobject
  • away_teamobject
  • datestring
  • home_teamobject
  • league_namestring
  • match_idinteger
  • next_matchesarray of object

    the next 5 in every competition, soonest first

  • away_teamobject
  • datestring
  • home_teamobject
  • league_namestring
  • match_idinteger
  • recordsobject
  • awayobject
  • homeobject
  • matches_without_resultinteger

    Computed records: league matches since the season start without a result (the records are then incomplete and stated by no sentence).

  • overallobject

Errors

StatusCodeWhen
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).
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?