Skip to main content

Arenas​

This endpoint allows you to retrieve the arenas. With geolocation parameter from geolocations endpoint we can see latitude and longitute of the arena.

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 arena by calling the following url: https://images.sportdevs.com/{hash_image}.png

Use Cases​

Get arenas
https://american-football.sportdevs.com/arenas

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

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

Query Parameters
  • id integer

    Default value: eq.1

    The id of the arena

  • country_id integer

    Default value: eq.1

    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 arena

    Note: This is a Primary Key.

  • name text

    The name of the arena

  • city text

    The city of the arena

  • stadium_capacity integer

    The capacity of the stadium

  • built text

    The built date of the arena

  • opened text

    The date when the arena opened

  • owner text

    The owner of the arena

  • operator text

    The operator of the arena

  • surface text

    The surface of the arena

  • cost text

    The cost of the arena

  • dimensions text

    The dimensions of the arena

  • 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

  • geolocation jsonb

    The geolocation

Loading...