Skip to content
API reference / Soccer
GET/soccer/matches/{id}/injuries

Get soccer injuries for a match

Returns all sidelined players reported for a single soccer match, with type, since, expected_return and matches_missed as on /soccer/injuries

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

Parameters

  • idinteger · pathrequired

    Match ID

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
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
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?