# Retrieve a paginated list of notes and its associated entity reference.

Retrieve information about a specific note or list of notes for an entity type within the Property Management System (PMS). This includes reference to the associated entities the note is linked to, i.e. ACTIVITY, BOOKING, CONTACT, COMPANY, ISSUE

Endpoint: GET /api/v3/notes
Version: 3.0.12
Security: X-Auth-Token

## Query parameters:

  - `noteId` (integer)
    ID of a specific note

  - `entityType` (string)
    Entity type of a specific note

  - `pageable` (object, required)

## Response 200 fields (application/json):

  - `content` (array)

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

  - `content.note` (string)
    Content of the note

  - `content.reason` (object)
    Lost reason

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

  - `content.reason.reason` (string)
    Description of the reason

  - `content.reason.turnedAway` (boolean)
    Indicates if the reason is for being turned away

  - `content.reason.type` (string)
    Type of the reason
    Enum: "CANCELLATION", "AMENDMENT"

  - `content.amendmentReason` (object)
    Lost reason

  - `content.noteCategory` (object)
    Category of the associated note, required if noteText is provided

  - `content.noteCategory.id` (integer)
    Unique identifier of the note category

  - `content.noteCategory.name` (string)
    Name of the note category

  - `content.noteCategory.defaultCategory` (boolean)
    Indicates if this is the default category

  - `content.noteCategory.buildingLimit` (integer)

  - `content.noteCategory.nameLowercase` (string)

  - `content.noteCategory.default` (integer)

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

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

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

  - `content.entitySummaryDTO` (object)
    Entity associated with the note

  - `content.entitySummaryDTO.id` (integer, required)
    Unique identifier of the entity

  - `content.entitySummaryDTO.type` (string, required)
    Type of entity for the note
    Enum: "ACTIVITY", "BOOKING", "CONTACT", "COMPANY", "ISSUE"

  - `content.private` (boolean)

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)