# Retrieve list of buildings

Retrieve a list of all buildings managed within the PMS. The response includes essential information for each building, such as its unique ID, name, address, facilities, and operational status. Optional query parameters can be included to refine the results, such as filtering by city, operational status, or specific attributes. This endpoint is particularly useful for displaying a catalogue of properties, managing building records, or integrating building data with external systems.

Endpoint: GET /api/v3/buildings
Version: 3.0.4
Security: OAuth2

## Query parameters:

  - `buildingName` (string)
    Name of the building to search for

  - `developmentName` (string)
    Name of the development to search for

  - `developmentId` (integer)
    Id of the development to search for

  - `areaName` (string)
    Name of the area to search for

  - `areaId` (integer)
    Id of the area to search for

  - `pageable` (object, required)

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    Unique identifier of the building

  - `content.areaId` (string)
    Unique identifier of the area

  - `content.postCode` (string)
    Postal code of the building

  - `content.areaName` (string)
    Name of the area

  - `content.city` (string)
    City where the building is located

  - `content.buildingName` (string)
    Name of the building

  - `content.developmentId` (string)
    Unique identifier of the development

  - `content.developmentName` (string)
    Name of the development

  - `content.addressLine1` (string)
    First line of the building's address

  - `content.addressLine2` (string)
    Second line of the building's address

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)