---
title: "Search places | Cerca luoghi"
method: GET
path: "/v2/places"
tags: ["Places"]
---

# Search places | Cerca luoghi

`GET /v2/places`

## Request

- Base URL: `https://app.didattica.polito.it/api`
- URL: `https://app.didattica.polito.it/api/v2/places`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/polito/apis/polito-faculty-api/docs/v2/places/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `search` string
- `placeCategoryId` string
- `placeSubCategoryId[]` string[]
- `siteId` string
- `buildingId` string
- `floorId` string
- `departmentId` string

## Response `200`

The request has succeeded.

- object
  - `data` PlaceOverview[], required
    - `latitude` number, required
    - `longitude` number, required
    - `id` string, required
    - `room` object, required
      - `id` string, required
      - `name` string, required
    - `category` PlaceCategoryOverview, required
      - `id` string, required
      - `name` string, required
      - `showInMenu` boolean
      - `color` string
      - `markerUrl` string, url
      - `priority` number: A MapBox style priority number. 0 means most important, larger numbers are less important
      - `highlighted` boolean: If true, markers of this category should be shown initially on the map
      - `subCategory` PlaceCategory
        - `id` string, required
        - `name` string, required
        - `showInMenu` boolean
        - `color` string
        - `markerUrl` string, url
        - `priority` number: A MapBox style priority number. 0 means most important, larger numbers are less important
        - `highlighted` boolean: If true, markers of this category should be shown initially on the map
    - `site` object, required
      - `id` string, required
      - `name` string, required
    - `building` BuildingOverview, required
      - `id` string, required
      - `name` string, required
      - `siteId` string, required
      - `category` PlaceCategoryOverview, required
        - `id` string, required
        - `name` string, required
        - `showInMenu` boolean
        - `color` string
        - `markerUrl` string, url
        - `priority` number: A MapBox style priority number. 0 means most important, larger numbers are less important
        - `highlighted` boolean: If true, markers of this category should be shown initially on the map
        - `subCategory` PlaceCategory
          - `id` string, required
          - `name` string, required
          - `showInMenu` boolean
          - `color` string
          - `markerUrl` string, url
          - `priority` number: A MapBox style priority number. 0 means most important, larger numbers are less important
          - `highlighted` boolean: If true, markers of this category should be shown initially on the map
      - `geoJson` GeoJsonPolygon
        - `type` 'Feature', required
        - `geometry` object, required
          - `type` 'Polygon', required
          - `coordinates` array[], required
            - array[]
              - …
    - `floor` Floor, required
      - `id` string, required
      - `name` string, required
      - `level` number, required
    - `department` Department, required
      - `id` string, required
      - `name` string, nullable, required
      - `type` string, required

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `500`: Server error

---

[API](https://skmtc.dev/polito/apis/polito-faculty-api.md) - [All operations](https://skmtc.dev/polito/apis/polito-faculty-api/llms.txt) - [OpenAPI document](https://skmtc.dev/polito/apis/polito-faculty-api/revisions/c29c33e75373?raw)