# Retrieve list of unit access groups

Fetch a list of all access groups associated with a specific unit within the Property Management System (PMS) using its unique ID. Access groups define the permissions and access levels for different users or roles within the unit. This endpoint is useful for retrieving detailed information about the access groups assigned to a unit, including their names, descriptions, and associated permissions. The response includes a list of access groups, which can be used for managing user access, security settings, and role-based permissions. If no access groups are found for the specified unit ID, an empty list will be returned. In case of an unexpected system error, a  will be triggered.

Endpoint: GET /api/v3/units/{id}/accessGroups
Version: 3.0.4
Security: OAuth2

## Path parameters:

  - `id` (integer, required)
    Unit ID

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    Unique identifier of the Unit Access Group

  - `content.unit` (object, required)
    Summary of the Unit associated with the Unit Access Group

  - `content.unit.id` (integer)
    Unique identifier of the unit
    Example: 1

  - `content.unit.name` (string)
    Name of the unit
    Example: "Apartment 101"

  - `content.accessGroup` (object, required)
    Access Group DTO

  - `content.accessGroup.id` (integer)
    Id of Access Group

  - `content.accessGroup.name` (string, required)
    Name of Access Group

  - `content.accessGroup.building` (object, required)
    Building associated with the unit type

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

  - `content.accessGroup.building.name` (string)
    Name of the building

  - `content.accessGroup.externalIdentifier` (string, required)
    External Identifier of Access Group

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)