GET
/
cities
curl --location -g --request GET 'https://api.stream.estate/cities' \
--header 'Content-Type: application/json'
--header 'X-API-KEY:'

{
  "hydra:member": [
    {
            "@id": "/cities/1",
            "@type": "City",
            "zipcode": "01500",
            "insee": "01004",
            "article": "",
            "name": "Ambérieu-en-Bugey",
            "libelle": "AMBERIEU EN BUGEY",
            "department": "/departments/1",
            "cityParent": {
                "@id": "/cities/37152",
                "@type": "City",
                "zipcode": "01500",
                "insee": "01004",
                "article": "",
                "name": null,
                "libelle": null
            },
            "originalName": "Ambérieu-en-Bugey"
        },
        {
            "@id": "/cities/2",
            "@type": "City",
            "zipcode": "01330",
            "insee": "01005",
            "article": "",
            "name": "Ambérieux-en-Dombes",
            "libelle": "AMBERIEUX EN DOMBES",
            "department": "/departments/1",
            "cityParent": {
                "@id": "/cities/37153",
                "@type": "City",
                "zipcode": "01330",
                "insee": "01005",
                "article": "",
                "name": null,
                "libelle": null
            },
            "originalName": "Ambérieux-en-Dombes"
        }
  ]
}

​
Query parameters

​
excludeGroupedCities
boolean
default:"false"

Set to true to exclude cities that have grouped cities under them. Example: excludeGroupedCities=true

​
insee
string

Filter by INSEE code.

​
insee[]
array of strings

Filter by multiple INSEE codes.

​
polygon
string

Filter by cities inside a given polygon defined by GPS coordinates. Example: polygon=polygon[0][lat]=43.12&polygon[0][lon]=5.93&polygon[1][lat]=43.12&polygon[1][lon]=6.01&polygon[2][lat]=43.07&polygon[2][lon]=6.01&polygon[3][lat]=43.07&polygon[3][lon]=5.93

​
libelle
string

Filter by city label/display name.

​
name
string

Filter by city name.

​
order[name]
string
default:"asc"

Sort by name. Enum: "asc" "desc"

​
page
integer
default:"1"

The collection page number.

​
slug
string

Filter by city slug.

​
zipcode
string

Filter by zipcode.

​
zipcode[]
array of strings

Filter by multiple zipcodes.

curl --location -g --request GET 'https://api.stream.estate/cities' \
--header 'Content-Type: application/json'
--header 'X-API-KEY:'

{
  "hydra:member": [
    {
            "@id": "/cities/1",
            "@type": "City",
            "zipcode": "01500",
            "insee": "01004",
            "article": "",
            "name": "Ambérieu-en-Bugey",
            "libelle": "AMBERIEU EN BUGEY",
            "department": "/departments/1",
            "cityParent": {
                "@id": "/cities/37152",
                "@type": "City",
                "zipcode": "01500",
                "insee": "01004",
                "article": "",
                "name": null,
                "libelle": null
            },
            "originalName": "Ambérieu-en-Bugey"
        },
        {
            "@id": "/cities/2",
            "@type": "City",
            "zipcode": "01330",
            "insee": "01005",
            "article": "",
            "name": "Ambérieux-en-Dombes",
            "libelle": "AMBERIEUX EN DOMBES",
            "department": "/departments/1",
            "cityParent": {
                "@id": "/cities/37153",
                "@type": "City",
                "zipcode": "01330",
                "insee": "01005",
                "article": "",
                "name": null,
                "libelle": null
            },
            "originalName": "Ambérieux-en-Dombes"
        }
  ]
}