Skip to main content

Teams​

This endpoint allows you to retrieve the teams.

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.

You can get the image of the team by calling the following url: https://images.sportdevs.com/{hash_image}.png

Use Cases​

Get teams
https://handball.sportdevs.com/teams

Get team based on the name
https://handball.sportdevs.com/teams?name=like.*Real*

Get team based on the id
https://handball.sportdevs.com/teams?id=eq.{id}

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

Get teams from a specific category_id
https://handball.sportdevs.com/teams?category_id=eq.{category_id}

Get teams from a specific arena_id
https://handball.sportdevs.com/teams?arena_id=eq.{arena_id}

Get teams from a specific coach_id
https://handball.sportdevs.com/teams?coach_id=eq.{coach_id}

Get team from a specific primary_league_id
https://handball.sportdevs.com/teams?primary_league_id=eq.{primary_league_id}

Query Parameters
  • id integer

    Default value: eq.1336

    The id of the team

  • country_id integer

    Default value: eq.20

    The id of the country

  • class_id integer

    Default value: eq.367

    The id of the class

  • tournament_id integer

    Default value: eq.683

    The id of the tournament

  • primary_league_id integer

    Default value: eq.2165

    The id of the primary league

  • arena_id integer

    Default value: eq.763

    The id of the arena

  • coach_id integer

    Default value: eq.699

    The id of the coach

  • 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 team

    Note: This is a Primary Key.

  • name text

    The name of the team

  • short_name text

    The short name of the team

  • full_name text

    The full name of the team

  • gender character

    Possible values: <= 1 characters

    The gender of the team

  • name_code text

    The name code of the team

  • national boolean

    If the team is national

  • type integer

    The type of the team

  • color_primary character varying

    Possible values: <= 7 characters

    The primary color of the team

  • color_secondary character varying

    Possible values: <= 7 characters

    The secondary color of the team

  • color_text character varying

    Possible values: <= 7 characters

    The text color of the team

  • foundation_date timestamp with time zone

    The foundation date of the team

  • 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

  • class_id integer

    The id of the class

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

  • class_name text

    The name of the class

  • class_hash_image character varying

    Possible values: <= 64 characters

    The name image of the class

  • tournament_id integer

    The id of the tournament

    Note: This is a Foreign Key to seasons-by-tournament.tournament_id.

  • tournament_name text

    The name of the tournament

  • primary_league_id integer

    The id of the primary league

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

  • primary_league_name text

    The name of the primary league

  • primary_league_hash_image character varying

    Possible values: <= 64 characters

    The name image of the primary league

  • arena_id integer

    The id of the arena

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

  • arena_name text

    The name of the arena

  • arena_hash_image character varying

    Possible values: <= 64 characters

    The name image of the arena

  • coach_id integer

    The id of the coach

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

  • coach_name text

    The name of the coach

  • coach_hash_image character varying

    Possible values: <= 64 characters

    The name image of the coach

Loading...