Skip to main content

Countries​

This endpoint allows you to retrieve the countries. You can use the alpha field to get the country.

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

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

Use Cases​

Get countries
https://beach-volleyball.sportdevs.com/countries

Get country based on the id
https://beach-volleyball.sportdevs.com/countries?id=eq.{id}

Get countries based on the alpha
https://beach-volleyball.sportdevs.com/countries?alpha=eq.{alpha}

Query Parameters
  • id integer

    Default value: eq.1

    The id of the country

  • alpha character varying

    Default value: eq.CA

    The alpha name 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 country

    Note: This is a Primary Key.

  • name text

    The name of the country

  • alpha character varying

    Possible values: <= 2 characters

    The alpha name of the country

  • hash_image character varying

    Possible values: <= 64 characters

    The name of the image

Loading...