.png%3Falt%3Dmedia%26token%3D21947f78-6585-4468-bf7f-df26530c8a43)
.png%3Falt%3Dmedia%26token%3D21947f78-6585-4468-bf7f-df26530c8a43)
GET All Cities
Returns all cities available within your subscription.
Base URL
Example Response
Field Description
https://api.sportmonks.com/v3/core/cities
{
"data": {
"id": 53253,
"country_id": 32,
"region_id": 428,
"name": "Madrid",
"latitude": "21.9",
"longitude": "-78.0833333",
"geonameid": 3117735
},
Field | Description | Type |
|---|---|---|
id | Refers to the id of the city | integer |
country_id | Refers to the country of the city | integer |
region | Refers to the region of the city | integer |
name | Displays the name of the city | string |
latitude | The official latitude of the city | string |
longitude | The official lonitude of the city | string |
geonameid | The official geo name id of the city | integer |
Query Parameters
Static Filters
Dynamic Filters
Query Parameters | Required? | Description |
|---|---|---|
api_token | YES | Your unique API token |
include | NO | Enrich the API with more data by using includes |
select | NO | |
filters | NO | Filter the API response on multiple related entities. There are static filters and dynamic filters. Please find the possibilities in the Static and Dynamic Filter tab. |
Static filters are always the same and filter in one specific way without any custom options. Each static filter is listed below and has a description of how it filters. For more information, please look at our Filters page.
Static Filters | Available on Entity | Description | Example |
|---|---|---|---|
IdAfter | GET All Cities | Filter all cities starting from a certain city ID. Handy if you're doing an import for all cities and want to continue from a certain ID. | &filters=IdAfter:cityID
|
Not applicable for this endpoint.
Yes
You can use a total of
4 nested includes on this endpoint
Related Entities:
Get an overview and explanation of all the fields returned in the API response. The related entities for the cities' endpoints are:
Ruby
Python
PHP
Java
Node.js
Go
require "uri"
require "net/http"
url = URI("https://api.sportmonks.com/v3/core/cities?api_token={your_token}")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body
import http.client
conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/core/cities?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.sportmonks.com/v3/core/cities?api_token={your_token}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $respons
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://api.sportmonks.com/v3/core/cities?api_token={your_token}")
.method("GET", null)
.build();
Response response = client.newCall(request).execute();
var unirest = require('unirest');
var req = unirest('GET', 'https://api.sportmonks.com/v3/core/cities?api_token={your_token}')
.end(function (res) {
if (res.error) throw new Error(res.error);
console.log(res.raw_body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.sportmonks.com/v3/core/cities?api_token={your_token}"
method := "GET"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Last modified 8mo ago