# list
## List of all stadiums ⬜ 🟨 🟦 🟩
`GET` `https://api.soccerfootball.info/v1/stadiums/list/`
This endpoint return with all Stadiums and his data.\
This is a paginate call, see instruction inside FAQ\
If this entity has **`has_image`** to true, you can access/download the entity media; see te instruction inside FAQ\
The parameter **`c`** must be a country code get from /v1/countries/list endpoint.\
Format CSV is in MS excel compatible mode (double click open without import!)\
The latest data are on the last page
#### Query Parameters
| Name | Type | Description |
| ---- | ------ | ------------------------------------------------------- |
| t | string | Your API token **`DIRECT API ONLY`** |
| f | string | Format response can be "json" or "csv" (default "json") |
| p | string | ***Page*** number (default value is 1) |
| c | string | ***Country*** code or "all" (default value is "all") |
#### Headers
| Name | Type | Description |
| --------------- | ------ | --------------------------------------------------- |
| X-RapidAPI-Key | string | Your API token **`RAPIDAPI ONLY`** |
| X-RapidAPI-Host | string | soccerfootballinfo.rapidapi.com **`RAPIDAPI ONLY`** |
{% tabs %}
{% tab title="200 Success response" %}
{% tabs %}
{% tab title="JSON" %}
```javascript
{
"status": 200,
"errors": [],
"pagination": [
{
"page": 1, // current page
"per_page": 100, // items per page
"items" : 6726 // total items number
}
],
"result": [
{
"id":"5fb969788aa64e3c", // unique stadium ID
"name":"Doha Stadium",
"city": "Sakhnin",
"country" : "IS",
"capacity" : "8500",
"coordinates" : "32.866692,35.310850",
"has_image": false // if true can get media
},
...
]
}
```
{% endtab %}
{% tab title="CSV" %}
```
page_1_perPage_100_items_6842;id;name;country;capacity;geocoords;has_image
;5fb969788aa64e3c;"Doha Stadium";IL;8500;32.866692,35.310850;no
...
```
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}
{% file src="" %}
## Example of code for direct API
{% tabs %}
{% tab title="PHP" %}
```php
$url = 'https://api.soccerfootball.info/v1/stadiums/list/?t=TOKEN';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $url,
CURLOPT_PROXY => null,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_CUSTOMREQUEST => "GET"
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if (!$err) {
$result = json_decode($response);
print_r($result);
} else {
echo "cURL Error:" . $err;
}
```
{% endtab %}
{% tab title="Javascript" %}
```python
fetch("https://api.soccerfootball.info/v1/stadiums/list/?t=TOKEN", {
"method": "GET"
})
.then(response => {
console.log(response);
})
.catch(err => {
console.error(err);
});
```
{% endtab %}
{% tab title="NodeJS" %}
```javascript
const request = require('request');
const options = {
method: 'GET',
url: 'https://api.soccerfootball.info/v1/stadiums/list/?t=TOKEN'
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
```
{% endtab %}
{% tab title="Phyton" %}
```python
import requests
url = "https://api.soccerfootball.info/v1/stadiums/list/?t=TOKEN"
response = requests.get(url).json()
print(response)
```
{% endtab %}
{% tab title="cURL" %}
```bash
curl --request GET \
--url 'https://api.soccerfootball.info/v1/stadiums/list/?t=TOKEN'
```
{% endtab %}
{% tab title="GO" %}
```go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.soccerfootball.info/v1/stadiums/list/?t=TOKEN"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
```
{% endtab %}
{% endtabs %}
## Example of code for RapidAPI
{% tabs %}
{% tab title="PHP" %}
```php
$url = 'https://soccer-football-info.p.rapidapi.com/stadiums/list/';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $url,
CURLOPT_PROXY => null,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-RapidAPI-Host: soccer-football-info.p.rapidapi.com",
"X-RapidAPI-Key: TOKEN"
],
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if (!$err) {
$result = json_decode($response);
print_r($result);
} else {
echo "cURL Error:" . $err;
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
fetch("https://soccer-football-info.p.rapidapi.com/stadiums/list/", {
"method": "GET",
"headers": {
"X-RapidAPI-Key": "TOKEN",
"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
}
})
.then(response => {
console.log(response);
})
.catch(err => {
console.error(err);
});
```
{% endtab %}
{% tab title="NodeJS" %}
```javascript
const request = require('request');
const options = {
method: 'GET',
url: "https://soccer-football-info.p.rapidapi.com/stadiums/list/",
headers: {
"X-RapidAPI-Key": "TOKEN",
"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
useQueryString: true
}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
```
{% endtab %}
{% tab title="Phyton" %}
```python
import requests
url = "https://soccer-football-info.p.rapidapi.com/stadiums/list"
headers = {
"X-RapidAPI-Key": "TOKEN",
"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
}
response = requests.request("GET", url, headers=headers)
print(response.text)
```
{% endtab %}
{% tab title="cURL" %}
```bash
curl --request GET \
--url https://soccer-football-info.p.rapidapi.com/stadiums/list/ \
--header 'X-RapidAPI-Host: soccer-football-info.p.rapidapi.com' \
--header 'X-RapidAPI-Key: TOKEN'
```
{% endtab %}
{% tab title="GO" %}
```go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://soccer-football-info.p.rapidapi.com/stadiums/list/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-RapidAPI-Key", "TOKEN")
req.Header.Add("X-RapidAPI-Host", "soccer-football-info.p.rapidapi.com")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
```
{% endtab %}
{% endtabs %}
More example of code on [rapidAPI](https://rapidapi.com/soccerfootball-info-soccerfootball-info-default/api/soccer-football-)