Skip to content
Get a key
API reference / Soccer
GET/soccer/injuries

List soccer injuries

Returns a paginated list of sidelined soccer players (one row per player and match) with optional filtering. Each row has type (from the status text: injury, suspension, illness, international_duty, personal, other, unknown), since and expected_return (YYYY-MM-DD from the player profile's sidelined list when a spell of the same type covers the match, else null; the provider's lists end in September 2025, so nearly always null), and matches_missed: the team's played matches before this one in which the player was listed, counted back without a gap, with matches_missed_complete false when the count reached a match our injury feed did not cover (a lower bound). Never guessed: unknown is null.

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

Parameters

  • limitinteger · query

    Maximum results (1-100)

    Default: 50
  • offsetinteger · query

    Results to skip

    Default: 0
  • league_idinteger · query

    Filter by league ID

  • team_idinteger · query

    Filter by team ID

  • datestring · query

    Filter by match date (YYYY-MM-DD)

  • date_fromstring · query

    Match date on or after (YYYY-MM-DD)

  • date_tostring · query

    Match date on or before (YYYY-MM-DD)

  • statusstring · query

    Filter by injury status substring (e.g. Knee Injury, Red Card)

  • availabilitystring · query

    Filter by availability (to_miss, questionable)

Response

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

  • dataarray of object
  • availabilitystring
  • expected_returnstring
  • idinteger
  • leagueobject
  • idinteger
  • namestring
  • match_datestring
  • match_idinteger
  • matches_missedinteger

    MatchesMissed: the team's played matches before this one in which the player was listed, counted back without a gap; complete false when the count reached a match the injury feed did not cover (a lower bound). Null without a player id.

  • matches_missed_completeboolean
  • playerobject
  • idinteger
  • namestring
  • sidestring
  • sincestring

    Since and ExpectedReturn (YYYY-MM-DD) from the player profile's sidelined list when a spell of the same type covers the match; null when unknown (the provider's lists end in September 2025, so mostly null).

  • sportstring
  • statusstring
  • suspension_riskobject

    SuspensionRisk: the player's card state in this league now (suspended, possibly_suspended, one_booking_away; see /soccer/leagues/{id}/suspensions), on rows of today's or later matches; omitted without one.

  • completeboolean
  • counted_yellowsinteger
  • league_idinteger
  • matches_leftinteger
  • matches_left_mininteger
  • next_thresholdinteger
  • reasonstring
  • statusstring
  • yellow_cardsinteger
  • teamobject
  • idinteger
  • namestring
  • typestring

    Type from the status text: injury, suspension, illness, international_duty, personal, other or unknown.

  • 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).
429RATE_LIMIT_EXCEEDEDToo many requests (QUOTA_EXCEEDED for the daily limit). Wait for Retry-After.
500INTERNAL_ERROROur side. Try again after a few seconds and check the status page.

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?