# Retrieve list of units

Fetch a list of all units within the Property Management System (PMS). This endpoint is useful for retrieving detailed information about units, including their availability, capacity, amenities, and pricing. The response includes a paginated list of units, which can be used for inventory management, booking operations, and property administration. If no units are found, an empty list will be returned. In case of an unexpected system error, a  will be triggered.

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

## Query parameters:

  - `buildingId` (integer)
    Filter by building name

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    ID of the unit

  - `content.bookable` (boolean)
    Whether the unit is bookable

  - `content.postCode` (string)
    Postcode of the unit

  - `content.city` (string)
    City of the unit

  - `content.unitName` (string)
    Name of the unit

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

  - `content.unitTypeName` (string)
    Type name of the unit

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

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

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)