Locations

Search for locations

Changed on

Search for locations by query. Returns predictions with venue badges for locations that are managed venues on the platform. The query parameter is required.

get/locations

Request

  • Base URL: https://api.session.services
  • URL: https://api.session.services/locations
  • Auth: API key in header x-tenant-id

Query parameters

querystring required

Search query for location search

Example:sydney opera
latitudenumber

User's latitude for proximity-based results (optional for better relevance)

Example:-33.8944593
longitudenumber

User's longitude for proximity-based results (optional for better relevance)

Example:151.2252255
typesstring[]

Filter results by Google Place types (e.g., 'establishment', 'night_club', 'bar')

[
  "establishment"
]

Response

OK

Example response

{
  "predictions": [
    {
      "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
      "name": "Watson's EQ",
      "description": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
      "venue": {
        "id": "ven_01jqpjksnsen9vprw95et60t2m",
        "name": "Sydney Opera House",
        "image": {
          "src": "https://assets.session.services/my-image.jpg",
          "alt": "My Image",
          "width": 1080,
          "height": 1080
        }
      }
    }
  ]
}

Changes