Skip to main content

Referees​

This endpoint allows you to retrieve the referees.

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 day.
Recommended Calls: Limit calls to 1 per day.

Use Cases​

Get referees based on the id
https://football.sportdevs.com/referees?id=eq.{id}

Get referees from a specific country_id
https://football.sportdevs.com/referees?country_id=eq.{country_id}

Query Parameters
  • id integer

    Default value: eq.9

    The id of the referee

  • country_id integer

    Default value: eq.3

    The id of the country

  • offset string

    Default value: 0

    Limiting and Pagination

  • limit string

    Default value: 50

    Limiting and Pagination

  • lang string

    Default value: en

    Multi-language

Responses

OK

Schema array
  • id integer

    The id of the referee

    Note: This is a Primary Key.

  • name text

    The name of the referee

  • yellow_cards integer

    The number of yellow cards given by the referee

  • red_cards integer

    The number of red cards given by the referee

  • yellow_red_cards integer

    The number of yellow-red cards given by the referee

  • matches_count integer

    The number of games played by the referee

  • date_of_birth timestamp with time zone

    The date of the referee's birth

  • first_debut_timestamp timestamp with time zone

    The id of the first tournament played by the referee

  • hash_image character varying

    Possible values: <= 64 characters

    The name of the image

  • country_id integer

    The id of the country

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

  • country_name text

    The name of the country

  • country_hash_image character varying

    Possible values: <= 64 characters

    The name image of the country

Loading...