Skip to main content

Matches Incidents​

This endpoint allows you to retrieve the incidents from matches.

For incidents we have many types: goal, period, card, suspension, inGamePenalty, penaltyShootout.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every 10 seconds during a live match.
Recommended Calls: Limit calls to 1 per 10 seconds during a live match.

Use Cases​

Get incidents from a specific match_id
https://handball.sportmicro.com/matches-incidents?match_id=eq.{match_id}

Query Parameters
  • match_id integer

    The id of the match

    Example: eq.32
  • offset string

    Default value: 0

    Limiting and Pagination

    Example: 0
  • limit string

    Default value: 50

    Limiting and Pagination

    Example: 50
  • lang string

    Default value: en

    Multi-language

    Example: en
Responses

OK

Schema array
  • match_id integer

    The id of the match

    Note: This is a Foreign Key to matches.id.

  • incidents jsonb

    The incidents of the match

Loading...