Skip to main content

Autocomplete Search Boundaries deprecated

GET 
/v4/boundaries/suggestions

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

This endpoint returns a list of boundaries based on search criteria.

Request​

Query Parameters

    contains stringrequired

    The text search query you would like to use to search for boundaries (formerly 

    starts-with
    )).All searches are case-insensitive.

    layer string[]

    The layer or layers you seek to obtain boundary information from.

    Possible values: [city, postal-code, area-level-1, area-level-2, postal-city, district, neighborhood, micro-neighborhood, subdivision, school-district, school-attendance-area]

    Default value: [postal-code, neighborhood, district, city, area-level-1, area-level-2]

    area-level-1 string[]

    The first political subdivision of a country for which you seek to obtain boundary information from. Common equivalents are states or provinces. Use the full name.

    area-level-2 string[]

    The second political subdivision of a country which you seek to obtain boundary information from. Common equivalents are Counties or Parishes Use the full name. Not guaranteed in every country.

    Examples:

    Example: King

    mls string[]

    The MLS code you want associated boundary IDs from.

    Example: &mls=recolorado&mls=pikespeak
    latitude string

    The latitude used to sort-by distance

    longitude string

    The longitude used to sort-by distance

    limit number

    The number of records you would like returned. The default is 20, the maximum is 50.

    Default value: 20

    offset number

    Used for pagination, the number of records for the collection to skip.

    Default value: 0

    sort-by string

    Sort by the following parameters.

    • name
    • population
    • distance

    Note: If you sort by distance, you must provide a latitude and longitude.

    Possible values: [name, population, distance]

Responses​

Schema

    successbooleanrequired

    pagination

    object

    required

    pageTotalnumberrequired
    limitnumberrequired
    offsetnumberrequired

    data

    object[]

  • Array [

    • idstringrequired

    The LiveBy Boundary ID.

    layerstringrequired
    namestringrequired
    vectorTileIdnumberrequired

    boundingBox

    object

    required

    typestringrequired

    coordinates

    object

    required

    oneOf

  • Array [

    • type
    itemsnumber[]

    Possible values: >= 2, <= 2

  • ]

    • address

    object

    required

    postcodestring
    citystring
    municipalitystring
    villagestring
    districtstring
    subdistrictstring
    archipelagostring
    territorystring
    islandstring
    provincestring
    statestring
    countystring
    townshipstring
    regionstring
    townstring
    localitystring

  • ]