Skip to main content
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"
        }
  ]
}