Location

Update Operating Cost Period

HTTP Request

PUT /api/locations/{locationId}/operating-cost-periods/{id}

📋 Description: Updates the operating cost period for a specified location within the Nakisa Portfolio Management Suite, enabling accurate financial analytics and portfolio management for real estate assets.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

id

path

integer(int64)

true

Unique identifier for the resource

body

body

OperatingCostPeriodDto

true

Request body containing the updated operating cost period details, including financial metrics and relevant metadata for effective portfolio and asset management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

OperatingCostPeriodDto

Get Location

HTTP Request

GET /api/locations/{id}

📋 Description: Retrieves detailed information about a specific location within the Nakisa Portfolio Management Suite, enabling users to analyze portfolio and asset data related to real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

LocationDto

Update Location

HTTP Request

PUT /api/locations/{id}

📋 Description: Updates the details of a specified location within the Nakisa Portfolio Management Suite, enabling users to maintain accurate information related to portfolio assets and real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

LocationDto

true

Request body containing updated location details, including address, asset allocation, and portfolio assignment, to enhance real estate property management within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

200

OK

OK

LocationDto

Delete Location

HTTP Request

DELETE /api/locations/{id}

📋 Description: Deletes a specified location from the Nakisa Portfolio Management Suite, ensuring the removal of associated portfolio and asset data for accurate real estate property analytics.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

None

Get Location Groups

HTTP Request

GET /api/locations/{id}/groups

📋 Description: Retrieves the groups associated with a specific location within the Nakisa Portfolio Management Suite, enabling users to analyze asset distribution and portfolio performance in real estate management.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[PickListOptionDto]

false

none

[Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» priority

integer(int64)

false

none

Priority of the resource

» internalId

integer(int64)

false

none

Unique identifier for the internal

» pickListCode

string

false

none

Code for the pick list

» pickListLabel

string

false

none

Label for the pick list

» label

string

false

none

Label for the resource

» cultureId

integer(int64)

false

none

Unique identifier for the culture

» labelDtos

[LabelDto]

false

none

List of labelDtos items

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» value

string

true

none

Text value for value in LabelDto

Create Or Update Location Groups

HTTP Request

PUT /api/locations/{id}/groups

📋 Description: Updates the group associations for a specified location within the Nakisa Portfolio Management Suite, enabling enhanced portfolio analytics and asset management for real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

GroupDto

true

Request body containing the group assignment details for the specified location, including portfolio identifiers and asset allocation metrics relevant to real estate property management.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[PickListOptionDto]

false

none

[Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» priority

integer(int64)

false

none

Priority of the resource

» internalId

integer(int64)

false

none

Unique identifier for the internal

» pickListCode

string

false

none

Code for the pick list

» pickListLabel

string

false

none

Label for the pick list

» label

string

false

none

Label for the resource

» cultureId

integer(int64)

false

none

Unique identifier for the culture

» labelDtos

[LabelDto]

false

none

List of labelDtos items

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» value

string

true

none

Text value for value in LabelDto

Transfer Group Option Locations

HTTP Request

POST /api/transfer-location-group-options

📋 Description: Creates a new transfer location group option within the Nakisa Portfolio Management Suite, enabling users to efficiently manage and analyze real estate property allocations across various portfolios.

Parameters

Name

In

Type

Required

Description

from-group-option-id

query

integer(int64)

true

Unique identifier for the source group option in the asset transfer process within the Nakisa Portfolio Management Suite.

to-group-option-id

query

integer(int64)

true

Unique identifier for the target location group option in the Nakisa Portfolio Management Suite, facilitating the transfer of assets within the portfolio analytics framework.

body

body

array[integer]

true

Request body containing the transfer location group options data, including portfolio identifiers, asset details, and relevant analytics for real estate property management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

None

Get Locations

HTTP Request

GET /api/locations

📋 Description: Retrieves a list of locations associated with real estate assets within the Nakisa Portfolio Management Suite, enabling users to analyze portfolio distribution and asset management insights.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the results of the location query should be returned in a paginated format, facilitating efficient data retrieval for portfolio and asset management analytics.

listing

query

boolean

false

Specifies whether to include detailed listing information for real estate properties in the portfolio analytics response.

search

query

string

false

Search term used to filter and retrieve specific locations within the Nakisa Portfolio Management Suite, relevant to portfolio, asset, analytics, and real estate property management.

address-id

query

string

false

Unique identifier for the specific address within the Nakisa Portfolio Management Suite, used to retrieve detailed information related to portfolio, asset, and real estate property analytics.

city-id

query

string

false

Unique identifier for a city within the Nakisa Portfolio Management Suite, used to retrieve location-specific data related to portfolio, asset, and real estate property analytics.

province-id

query

string

false

Unique identifier for the province, used to filter and retrieve location-specific data related to portfolios, assets, and real estate properties within the Nakisa Portfolio Management Suite.

country-id

query

string

false

Unique identifier for the country, used to filter and retrieve location-specific data related to portfolio, asset, and real estate property analytics.

city-id-in

query

string

false

Unique identifier for the city, used to filter and retrieve specific location data within the Nakisa Portfolio Management Suite for portfolio and asset analytics.

province-id-in

query

string

false

Unique identifier for the province, used to filter location data relevant to portfolio management and real estate analytics.

country-id-in

query

string

false

Unique identifier for the country, used to filter and retrieve location data relevant to portfolio, asset, and real estate property analytics within the Nakisa Portfolio Management Suite.

id-in

query

string

false

Unique identifier for the location within the Nakisa Portfolio Management Suite, facilitating precise retrieval of portfolio, asset, and analytics data related to real estate properties.

number

query

string

false

Specifies the unique identifier for a location within the Nakisa Portfolio Management Suite, facilitating precise asset and portfolio analytics in real estate property management.

number-like

query

string

false

Represents a numeric value or identifier associated with portfolio assets, facilitating precise location retrieval within the Nakisa Portfolio Management Suite.

name

query

string

false

Name of the resource

archived

query

string

false

Indicates whether to retrieve archived locations within the portfolio management suite, providing insights into historical asset data and analytics for real estate properties.

store-number

query

string

false

Identifies the specific store within the Nakisa Portfolio Management Suite, enabling targeted retrieval of location-related data for portfolio and asset analytics in real estate management.

default-currency-id

query

string

false

Identifier for the default currency used in financial transactions within the portfolio management context.

default-measure-id

query

string

false

Specifies the unique identifier for the default measurement associated with the portfolio, asset, or real estate property analytics within the Nakisa Portfolio Management Suite.

type-id

query

string

false

Unique identifier for the type of location within the Nakisa Portfolio Management Suite, facilitating targeted retrieval of portfolio, asset, and real estate property analytics.

quality-id

query

string

false

Unique identifier for the quality assessment associated with a specific real estate property within the Nakisa Portfolio Management Suite.

property-type-id

query

string

false

Unique identifier for the type of real estate property, used to filter and retrieve specific portfolio and asset analytics within the Nakisa Portfolio Management Suite.

category-id

query

string

false

Unique identifier for the category of locations within the Nakisa Portfolio Management Suite, facilitating targeted retrieval of portfolio, asset, and real estate property analytics.

legal-entity-id

query

string

false

Unique identifier for the legal entity associated with a specific location, facilitating accurate portfolio and asset analytics within the Nakisa Portfolio Management Suite.

business-unit-id-in

query

string

false

Unique identifier for the business unit, used to filter location data relevant to portfolio, asset, analytics, and real estate property management within the Nakisa Portfolio Management Suite.

status-id

query

string

false

Unique identifier for the status of a location within the Nakisa Portfolio Management Suite, facilitating portfolio and asset analytics in real estate property management.

status-id-in

query

string

false

Filters the locations returned by the API based on their associated status identifiers, enabling targeted analytics within the Nakisa Portfolio Management Suite for effective portfolio and asset management.

partner-id-in

query

string

false

Unique identifier for the partner associated with the portfolio, enabling targeted retrieval of location data within the Nakisa Portfolio Management Suite.

legal-entity-id-not-in

query

string

false

Specifies a comma-separated list of legal entity IDs to exclude from the location query results within the Nakisa Portfolio Management Suite, facilitating targeted portfolio and asset analytics in real estate property management.

legal-entity-id-in

query

string

false

Unique identifier for the legal entity associated with the portfolio, asset, or real estate property, used to retrieve relevant location data.

group-id-not-in

query

string

false

Specifies a comma-separated list of group IDs to exclude from the location query results within the Nakisa Portfolio Management Suite, facilitating targeted portfolio and asset analytics.

group-id-in

query

string

false

Unique identifier for the asset group within the Nakisa Portfolio Management Suite, used to filter location data relevant to portfolio and real estate analytics.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelLocationDto

Add Locations

HTTP Request

POST /api/locations

📋 Description: Creates a new location entry within the Nakisa Portfolio Management Suite, enabling users to manage and analyze real estate properties effectively within their portfolio.

Parameters

Name

In

Type

Required

Description

body

body

LocationDto

true

Request body containing the location details, including portfolio identifiers and asset attributes, essential for real estate property analytics within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[LocationDto]

false

none

[Data transfer object representing a location within the Nakisa Portfolio Management Suite, encapsulating essential details related to real estate properties, assets, and portfolio analytics.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» number

string

false

none

Text value for number in LocationDto

» name

string

true

none

Name of the resource

» storeNumber

string

true

none

Text value for storeNumber in LocationDto

» defaultCurrencyId

integer(int64)

true

none

Unique identifier for the default currency

» defaultMeasureId

integer(int64)

true

none

Unique identifier for the default measure

» typeId

integer(int64)

true

none

Unique identifier for the type

» qualityId

integer(int64)

false

none

Unique identifier for the quality

» propertyTypeId

integer(int64)

false

none

Unique identifier for the property type

» categoryId

integer(int64)

false

none

Unique identifier for the category

» statusId

integer(int64)

false

none

Unique identifier for the status

» businessUnitId

integer(int64)

false

none

Unique identifier for the business unit

» groupIds

[integer]

false

none

List of groupIds items

» legalEntityIds

[integer]

false

none

List of legalEntityIds items

» defaultCurrency

CurrencyDto

false

none

Data transfer object representing currency details utilized within the Nakisa Portfolio Management Suite, facilitating accurate financial analysis and reporting for portfolio, asset, and real estate property management.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» status

string

false

none

Status of the resource

»» displayId

string

true

none

Unique identifier for the display

»» erpSystemId

integer(int64)

false

none

Unique identifier for the erp system

»» erpSystemDisplayId

string

false

none

Unique identifier for the erp system display

»» name

string

false

none

Name of the resource

»» decimalPoints

integer(int32)

true

none

Numeric value representing decimalPoints

»» depreciationAreaId

integer(int64)

false

none

Unique identifier for the depreciation area

» defaultUnitValue

UnitDefaultValueDto

false

none

Data transfer object representing the default values for units within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset analytics for real estate properties.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» unitId

integer(int64)

false

none

Unique identifier for the unit

»» unitOfMeasureId

integer(int64)

false

none

Unique identifier for the unit of measure

»» erpSystemId

integer(int64)

false

none

Unique identifier for the erp system

»» unit

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» priority

integer(int64)

false

none

Priority of the resource

»»» internalId

integer(int64)

false

none

Unique identifier for the internal

»»» pickListCode

string

false

none

Code for the pick list

»»» pickListLabel

string

false

none

Label for the pick list

»»» label

string

false

none

Label for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» labelDtos

[LabelDto]

false

none

List of labelDtos items

»»»» createdBy

string

false

none

Username of who created this resource

»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»» createdDate

string(date-time)

false

none

Date of the created

»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»» externalId

string

false

none

Unique identifier for the external

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»»» value

string

true

none

Text value for value in LabelDto

»» unitOfMeasure

UnitOfMeasureDto

false

none

Data transfer object representing the unit of measure utilized within the Nakisa Portfolio Management Suite, essential for accurately quantifying and analyzing assets in the context of portfolio management and real estate property analytics.

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» status

string

false

none

Status of the resource

»»» displayId

string

true

none

Unique identifier for the display

»»» erpSystemId

integer(int64)

false

none

Unique identifier for the erp system

»»» erpSystemDisplayId

string

false

none

Unique identifier for the erp system display

»»» name

string

false

none

Name of the resource

» type

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» quality

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» propertyType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» category

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» status

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» addressDto

AddressDto

true

none

Data transfer object representing the address details associated with real estate properties within the Nakisa Portfolio Management Suite, facilitating accurate portfolio and asset analytics.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» street

string

false

none

Text value for street in AddressDto

»» civicNumber

string

false

none

Text value for civicNumber in AddressDto

»» suite

string

false

none

Text value for suite in AddressDto

»» postalCode

string

false

none

Code for the postal

»» lon

number(double)

false

none

Value for lon field

»» lat

number(double)

false

none

Value for lat field

»» city

City

false

none

Data transfer object representing a city within the Nakisa Portfolio Management Suite, encapsulating essential information related to real estate properties, portfolio management, and asset analytics. This object facilitates informed decision-making and strategic planning in urban asset management.

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» name

string

true

none

Name of the resource

»»» province

Province

false

none

Data transfer object representing a province within the Nakisa Portfolio Management Suite, encapsulating essential details for portfolio analysis and asset management in the context of real estate properties.

»»»» createdBy

string

false

none

Username of who created this resource

»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»» createdDate

string(date-time)

false

none

Date of the created

»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»» externalId

string

false

none

Unique identifier for the external

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» name

string

true

none

Name of the resource

»»»» code

string

false

none

Code identifier for the resource

»»»» country

Country

false

none

Data transfer object representing a country within the Nakisa Portfolio Management Suite, utilized for portfolio analysis and asset management in the context of real estate properties and analytics.

»»»»» createdBy

string

false

none

Username of who created this resource

»»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»»» createdDate

string(date-time)

false

none

Date of the created

»»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»»» externalId

string

false

none

Unique identifier for the external

»»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»»» name

string

true

none

Name of the resource

»»»»» code

string

false

none

Code identifier for the resource

»» district

District

false

none

Data transfer object representing a district within the Nakisa Portfolio Management Suite, encompassing key attributes related to portfolio management, asset allocation, and real estate property analytics.

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» name

string

true

none

Name of the resource

»»» city

City

false

none

Data transfer object representing a city within the Nakisa Portfolio Management Suite, encapsulating essential information related to real estate properties, portfolio management, and asset analytics. This object facilitates informed decision-making and strategic planning in urban asset management.

»» cityId

integer(int64)

false

none

Unique identifier for the city

»» districtId

integer(int64)

false

none

Unique identifier for the district

» secondAddressDto

AddressDto

false

none

Data transfer object representing the address details associated with real estate properties within the Nakisa Portfolio Management Suite, facilitating accurate portfolio and asset analytics.

Enumerated Values

Attribute

Value

status

ACTIVE, CREATED, DECOMMISSIONED, DISABLED

Get Pictures For Location

HTTP Request

GET /api/locations/{locationId}/pictures

📋 Description: Retrieves a list of images associated with a specific location within the Nakisa Portfolio Management Suite, facilitating enhanced asset visualization and analytics for real estate properties.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the results for pictures associated with a specific location should be returned in a paginated format, facilitating efficient data retrieval within the Nakisa Portfolio Management Suite.

locationId

path

string

true

Unique identifier for the location

search

query

string

false

Search term used to filter and retrieve specific pictures associated with the designated location within the Nakisa Portfolio Management Suite.

default

query

string

false

Specifies the default image to be retrieved for the real estate property associated with the given location ID in the Nakisa Portfolio Management Suite.

name

query

string

false

Name of the resource

type

query

string

false

Type of the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelLocationPictureDto

Upload Location Picture

HTTP Request

POST /api/locations/{locationId}/pictures

📋 Description: Uploads images associated with a specific location within the Nakisa Portfolio Management Suite, enhancing the visual representation of real estate assets for portfolio analytics.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

body

body

object

false

Request body containing the image data and associated metadata for the specified location, facilitating enhanced asset visualization and analytics within the Nakisa Portfolio Management Suite.

» file

body

string(binary)

true

none

» document

body

DocumentDto

true

Data transfer object representing a document within the Nakisa Portfolio Management Suite, encapsulating essential information related to portfolio assets, analytics, and real estate properties.

»» createdBy

body

string

false

Username of who created this resource

»» lastModifiedBy

body

string

false

Username of who last modified this resource

»» createdDate

body

string(date-time)

false

Date of the created

»» lastModifiedDate

body

string(date-time)

false

Date of the last modified

»» archived

body

boolean

false

Boolean flag indicating archived status

»» externalId

body

string

false

Unique identifier for the external

»» id

body

integer(int64)

false

Unique identifier for the resource

»» name

body

string

false

Name of the resource

»» title

body

string

false

Title of the resource

»» type

body

string

false

Type of the resource

»» description

body

string

false

Description of the resource

»» link

body

string

false

Text value for link in DocumentDto

»» signedDate

body

string(date)

false

Date of the signed

»» documentTypeId

body

integer(int64)

false

Unique identifier for the document type

»» statusId

body

integer(int64)

false

Unique identifier for the status

»» shareable

body

boolean

false

Boolean flag indicating shareable status

»» size

body

integer(int64)

false

Number of items per page

»» documentType

body

PickListOptionDto

false

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»» createdBy

body

string

false

Username of who created this resource

»»» lastModifiedBy

body

string

false

Username of who last modified this resource

»»» createdDate

body

string(date-time)

false

Date of the created

»»» lastModifiedDate

body

string(date-time)

false

Date of the last modified

»»» archived

body

boolean

false

Boolean flag indicating archived status

»»» externalId

body

string

false

Unique identifier for the external

»»» id

body

integer(int64)

false

Unique identifier for the resource

»»» priority

body

integer(int64)

false

Priority of the resource

»»» internalId

body

integer(int64)

false

Unique identifier for the internal

»»» pickListCode

body

string

false

Code for the pick list

»»» pickListLabel

body

string

false

Label for the pick list

»»» label

body

string

false

Label for the resource

»»» cultureId

body

integer(int64)

false

Unique identifier for the culture

»»» labelDtos

body

[LabelDto]

false

List of labelDtos items

»»»» createdBy

body

string

false

Username of who created this resource

»»»» lastModifiedBy

body

string

false

Username of who last modified this resource

»»»» createdDate

body

string(date-time)

false

Date of the created

»»»» lastModifiedDate

body

string(date-time)

false

Date of the last modified

»»»» archived

body

boolean

false

Boolean flag indicating archived status

»»»» externalId

body

string

false

Unique identifier for the external

»»»» id

body

integer(int64)

false

Unique identifier for the resource

»»»» cultureId

body

integer(int64)

false

Unique identifier for the culture

»»»» value

body

string

true

Text value for value in LabelDto

»» status

body

PickListOptionDto

false

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

Responses

Status

Meaning

Description

Schema

201

Created

Created

LocationPictureDto

Set Default Location Picture

HTTP Request

POST /api/locations/{locationId}/pictures/{pictureId}/default

📋 Description: Sets the specified picture as the default image for the designated location within the Nakisa Portfolio Management Suite, enhancing the visual representation of real estate assets in portfolio analytics.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

pictureId

path

integer(int64)

true

Unique identifier for the picture

Responses

Status

Meaning

Description

Schema

200

OK

OK

LocationPictureDto

Create Location To Partner

HTTP Request

POST /api/locations/{locationId}/partners

📋 Description: Creates a new partner association for a specified location within the Nakisa Portfolio Management Suite, enhancing portfolio analytics and asset management for real estate properties.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

body

body

LocationToPartnerDto

true

Request body containing partner information, including details such as name, role, and contact data, to associate with a specified location within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[LocationToPartnerDto]

false

none

[Data transfer object representing the association between a location and its corresponding partner within the Nakisa Portfolio Management Suite, facilitating insights into portfolio, asset management, and real estate property analytics.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» partnerId

integer(int64)

false

none

Unique identifier for the partner

» partnerRoleId

integer(int64)

false

none

Unique identifier for the partner role

» dateFrom

string(date)

false

none

Text value for dateFrom in LocationToPartnerDto

» dateTo

string(date)

false

none

Text value for dateTo in LocationToPartnerDto

» fosContactIds

[integer]

false

none

List of fosContactIds items

» locationId

integer(int64)

false

none

Unique identifier for the location

» partner

PartnerLite

false

none

Data transfer object representing a streamlined partner profile within the Nakisa Portfolio Management Suite, encompassing essential details for portfolio, asset, and analytics management in the real estate property sector.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» displayId

string

false

none

Unique identifier for the display

»» status

string

false

none

Status of the resource

»» name

string

false

none

Name of the resource

»» erpSystemDisplayId

string

false

none

Unique identifier for the erp system display

» partnerParent

PartnerLite

false

none

Data transfer object representing a streamlined partner profile within the Nakisa Portfolio Management Suite, encompassing essential details for portfolio, asset, and analytics management in the real estate property sector.

» partnerRole

PartnerRoleLite

false

none

Data transfer object representing a simplified view of a partner’s role within the Nakisa Portfolio Management Suite, facilitating insights into portfolio, asset, and real estate property analytics.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» displayId

string

false

none

Unique identifier for the display

»» status

string

false

none

Status of the resource

»» name

string

false

none

Name of the resource

Enumerated Values

Attribute

Value

status

ACTIVE, CREATED, DECOMMISSIONED, DISABLED

Get Operating Cost Periods For Location

HTTP Request

GET /api/locations/{locationId}/operating-cost-periods

📋 Description: Retrieves the operating cost periods associated with a specified location, providing essential data for portfolio and asset management analytics within the Nakisa Portfolio Management Suite.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

pageable

query

Pageable

true

Indicates whether the results for operating cost periods associated with a specific location should be returned in a paginated format, facilitating efficient data retrieval for portfolio and asset analysis.

location-id

query

string

false

Unique identifier for the specific location within the Nakisa Portfolio Management Suite, used to retrieve its associated operating cost periods for portfolio and asset analytics in real estate management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelOperatingCostPeriodDto

Add Operating Cost Periods To Location

HTTP Request

POST /api/locations/{locationId}/operating-cost-periods

📋 Description: Creates a new operating cost period for a specified location within the Nakisa Portfolio Management Suite, enabling enhanced analytics and management of real estate property expenses.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

body

body

OperatingCostPeriodDto

true

Request body containing the operating cost period details, including relevant financial metrics and timeframes, essential for effective portfolio and asset management in real estate analytics.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[OperatingCostPeriodDto]

false

none

[Data transfer object representing the operating cost period for assets within the Nakisa Portfolio Management Suite, facilitating analytics and insights related to portfolio and real estate property management.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» year

integer(int32)

false

none

Numeric value representing year

» statusId

integer(int64)

false

none

Unique identifier for the status

» expenses

[OperatingCostPeriodExpenseDto]

false

none

List of expenses items

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» operatingCostExpenseTypeId

integer(int64)

false

none

Unique identifier for the operating cost expense type

»» amount

number

true

none

Amount value

»» revisedAmount

number

false

none

Amount of revised

»» considerRevisedAmount

boolean

false

none

Amount of consider revised

»» operatingCostExpenseType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» priority

integer(int64)

false

none

Priority of the resource

»»» internalId

integer(int64)

false

none

Unique identifier for the internal

»»» pickListCode

string

false

none

Code for the pick list

»»» pickListLabel

string

false

none

Label for the pick list

»»» label

string

false

none

Label for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» labelDtos

[LabelDto]

false

none

List of labelDtos items

»»»» createdBy

string

false

none

Username of who created this resource

»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»» createdDate

string(date-time)

false

none

Date of the created

»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»» externalId

string

false

none

Unique identifier for the external

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»»» value

string

true

none

Text value for value in LabelDto

»» expenseGroup

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» status

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» leaseReconciliationPeriods

[LeaseReconciliationPeriodDto]

false

none

List of leaseReconciliationPeriods items

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» startDate

string(date)

false

none

Start date of the resource

»» endDate

string(date)

false

none

End date of the resource

»» statusId

integer(int64)

false

none

Unique identifier for the status

»» invoiceAmount

number

false

none

Amount of invoice

»» receivedDate

string(date)

false

none

Date of the received

»» acceptedAmount

number

false

none

Amount of accepted

»» reviewedBy

string

false

none

Text value for reviewedBy in LeaseReconciliationPeriodDto

»» reviewedDate

string(date)

false

none

Date of the reviewed

»» fullReconciliation

boolean

false

none

Boolean flag indicating fullReconciliation status

»» status

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»» operatingCostPeriodId

integer(int64)

false

none

Unique identifier for the operating cost period

»» reconciledExpenseCategoryDtos

[ReconciledExpenseCategoryDto]

false

none

List of reconciledExpenseCategoryDtos items

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» expenseGroupId

integer(int64)

false

none

Unique identifier for the expense group

»»» totalCost

number

false

none

Value for totalCost field

»»» accrualAmount

number

false

none

Amount of accrual

»»» balance

number

false

none

Value for balance field

»»» expenseGroup

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»» reconciledExpenseDtos

[ReconciledExpenseDto]

false

none

List of reconciledExpenseDtos items

»»»» createdBy

string

false

none

Username of who created this resource

»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»» createdDate

string(date-time)

false

none

Date of the created

»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»» externalId

string

false

none

Unique identifier for the external

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» totalCost

number

false

none

Value for totalCost field

»»»» operatingCostExpenseTypeId

integer(int64)

false

none

Unique identifier for the operating cost expense type

»»»» operatingCostExpenseType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»»» reconciledExpenseSegmentDtos

[ReconciledExpenseSegmentDto]

false

none

List of reconciledExpenseSegmentDtos items

»»»»» createdBy

string

false

none

Username of who created this resource

»»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»»» createdDate

string(date-time)

false

none

Date of the created

»»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»»» externalId

string

false

none

Unique identifier for the external

»»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»»» startDate

string(date)

false

none

Start date of the resource

»»»»» endDate

string(date)

false

none

End date of the resource

»»»»» adjustedLocationCost

number

false

none

Value for adjustedLocationCost field

»»»»» proSharePercentage

number

false

none

Percentage of pro share

»»»»» proShareCost

number

false

none

Value for proShareCost field

»»»»» cap

number

false

none

Value for cap field

»»»»» subtotalCost

number

false

none

Value for subtotalCost field

»»»»» adminFees

number

false

none

Value for adminFees field

»»»»» totalCost

number

false

none

Value for totalCost field

»»»»» conditionDto

LeaseConditionDto

false

none

Data transfer object representing the conditions associated with a lease within the Nakisa Portfolio Management Suite, facilitating insights and analytics for real estate property management and portfolio optimization.

»»»»»» createdBy

string

false

none

Username of who created this resource

»»»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»»»» createdDate

string(date-time)

false

none

Date of the created

»»»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»»»» externalId

string

false

none

Unique identifier for the external

»»»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»»»» typeId

integer(int64)

false

none

Unique identifier for the type

»»»»»» startDate

string(date)

false

none

Start date of the resource

»»»»»» endDate

string(date)

false

none

End date of the resource

»»»»»» replaceById

integer(int64)

false

none

Unique identifier for the replace by

»»»»»» managedById

integer(int64)

false

none

Unique identifier for the managed by

»»»»»» payById

integer(int64)

false

none

Unique identifier for the pay by

»»»»»» adminFee

number

false

none

Value for adminFee field

»»»»»» fixedIncreasePercentage

number

false

none

Percentage of fixed increase

»»»»»» note

string

false

none

Text value for note in LeaseConditionDto

»»»»»» pageNumber

string

false

none

Page number for pagination

»»»»»» section

string

false

none

Text value for section in LeaseConditionDto

»»»»»» type

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»»»»» replaceBy

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»»»»» managedBy

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»»»»» payBy

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»»»»» proShareDto

any

false

none

Value for proShareDto field

oneOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

ProShareDto

false

none

Data transfer object representing a comprehensive overview of a real estate property within the Nakisa Portfolio Management Suite, encompassing key portfolio and asset analytics for informed decision-making.

»»»»»»»» createdBy

string

false

none

Username of who created this resource

»»»»»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»»»»»» createdDate

string(date-time)

false

none

Date of the created

»»»»»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»»»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»»»»»» externalId

string

false

none

Unique identifier for the external

»»»»»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»»»»»» type

string

true

none

Type of the resource

xor

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

AreaBasedProShareDto

false

none

Data transfer object representing area-based professional sharing insights within the Nakisa Portfolio Management Suite, facilitating analytics and decision-making related to portfolio and asset management in real estate properties.

allOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

ProShareDto

false

none

Data transfer object representing a comprehensive overview of a real estate property within the Nakisa Portfolio Management Suite, encompassing key portfolio and asset analytics for informed decision-making.

and

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

object

false

none

none

»»»»»»»»» dividendAreaTypeId

integer(int64)

false

none

none

»»»»»»»»» divisorAreaTypeId

integer(int64)

false

none

none

»»»»»»»»» dividendAreaId

integer(int64)

false

none

none

»»»»»»»»» divisorAreaId

integer(int64)

false

none

none

»»»»»»»»» dividendAreaType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»»»»»»»» divisorAreaType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

xor

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

FixedPercentageProShareDto

false

none

Data transfer object representing a fixed percentage profit-sharing arrangement within the Nakisa Portfolio Management Suite, facilitating analytics and decision-making for real estate property assets in portfolio management.

allOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

ProShareDto

false

none

Data transfer object representing a comprehensive overview of a real estate property within the Nakisa Portfolio Management Suite, encompassing key portfolio and asset analytics for informed decision-making.

and

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

object

false

none

none

»»»»»»»»» fixedPercentage

number

false

none

none

continued

Name

Type

Required

Restrictions

Description

»»»»»» capDto

any

false

none

Value for capDto field

oneOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

CAPDto

false

none

Data transfer object representing a comprehensive view of portfolio assets within the Nakisa Portfolio Management Suite, facilitating analytics and insights for real estate property management.

»»»»»»»» createdBy

string

false

none

Username of who created this resource

»»»»»»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»»»»»»» createdDate

string(date-time)

false

none

Date of the created

»»»»»»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»»»»»»» archived

boolean

false

none

Boolean flag indicating archived status

»»»»»»»» externalId

string

false

none

Unique identifier for the external

»»»»»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»»»»»» type

string

true

none

Type of the resource

xor

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

FixedCAPDto

false

none

Data transfer object representing fixed capital assets within the Nakisa Portfolio Management Suite, encompassing key attributes for portfolio analysis, asset management, and real estate property evaluation.

allOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

CAPDto

false

none

Data transfer object representing a comprehensive view of portfolio assets within the Nakisa Portfolio Management Suite, facilitating analytics and insights for real estate property management.

and

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

object

false

none

none

»»»»»»»»» amount

number

false

none

none

xor

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

OverBaseCAPDto

false

none

Data transfer object representing a comprehensive overview of portfolio assets within the Nakisa Portfolio Management Suite, facilitating analytics and insights for real estate property management.

allOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

CAPDto

false

none

Data transfer object representing a comprehensive view of portfolio assets within the Nakisa Portfolio Management Suite, facilitating analytics and insights for real estate property management.

and

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

object

false

none

none

»»»»»»»»» baseYear

integer(int32)

false

none

none

»»»»»»»»» baseAmount

number

false

none

none

»»»»»»»»» maxIncreasePercentage

number

false

none

none

»»»»»»»»» cumulative

boolean

false

none

none

xor

Name

Type

Required

Restrictions

Description

»»»»»»» anonymous

OverYearCAPDto

false

none

Data transfer object representing the annual capital allocation projections for real estate properties within the Nakisa Portfolio Management Suite, facilitating portfolio analytics and asset management.

allOf - discriminator: type

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

CAPDto

false

none

Data transfer object representing a comprehensive view of portfolio assets within the Nakisa Portfolio Management Suite, facilitating analytics and insights for real estate property management.

and

Name

Type

Required

Restrictions

Description

»»»»»»»» anonymous

object

false

none

none

»»»»»»»»» baseYear

integer(int32)

false

none

none

»»»»»»»»» baseAmount

number

false

none

none

»»»»»»»»» maxIncreasePercentage

number

false

none

none

»»»»»»»»» cumulative

boolean

false

none

none

continued

Name

Type

Required

Restrictions

Description

»»» hasWarning

boolean

false

none

Whether the resource has has warning

Add Notes To Location

HTTP Request

POST /api/locations/{locationId}/notes

📋 Description: Creates a new note associated with a specified location within the Nakisa Portfolio Management Suite, enhancing portfolio and asset management by allowing users to document insights or observations related to real estate properties.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

body

body

NoteDto

true

Request body containing the note details, including text and associated metadata, for the specified location within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[NoteDto]

false

none

[Data transfer object representing a note associated with portfolio management, asset analytics, and real estate properties, facilitating effective communication and documentation within the Nakisa Portfolio Management Suite.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» message

string

true

none

Text value for message in NoteDto

» userIds

[integer]

false

none

User information related to portfolio management

» redirectUrl

string

false

none

Text value for redirectUrl in NoteDto

Get Location Documents

HTTP Request

GET /api/locations/{locationId}/documents

📋 Description: Retrieves documents associated with a specific location within the Nakisa Portfolio Management Suite, enabling users to access critical information related to portfolio, asset, and real estate property analytics.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

pageable

query

Pageable

true

Indicates whether the response should be paginated, facilitating efficient retrieval of document data associated with a specific location within the Nakisa Portfolio Management Suite.

search

query

string

false

Search term used to filter documents related to a specific location within the Nakisa Portfolio Management Suite, enhancing portfolio and asset analytics for real estate properties.

id

query

string

false

Unique identifier for the resource

status-id

query

string

false

Unique identifier for the status of documents associated with a specific location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

signed-date

query

string

false

Specifies the date on which the document was signed, providing essential context for portfolio and asset management within the Nakisa Portfolio Management Suite.

name

query

string

false

Name of the resource

title

query

string

false

Title of the resource

type

query

string

false

Type of the resource

shareable

query

string

false

Indicates whether the documents associated with the specified location can be shared, facilitating collaboration and transparency in portfolio and asset management within the Nakisa Portfolio Management Suite.

document-type-id

query

string

false

Unique identifier for the type of document associated with a specific location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

document-type-id-in

query

string

false

Unique identifier for the type of document associated with a specific location, facilitating targeted retrieval of portfolio, asset, and real estate property analytics.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelDocumentDto

Upload Location Document

HTTP Request

POST /api/locations/{locationId}/documents

📋 Description: Uploads documents associated with a specific location in the Nakisa Portfolio Management Suite, enhancing asset management and analytics for real estate properties.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

body

body

object

false

Request body containing the document details, including metadata and associated asset information, for the specified real estate property within the Nakisa Portfolio Management Suite.

» file

body

string(binary)

false

none

» document

body

DocumentDto

true

Data transfer object representing a document within the Nakisa Portfolio Management Suite, encapsulating essential information related to portfolio assets, analytics, and real estate properties.

»» createdBy

body

string

false

Username of who created this resource

»» lastModifiedBy

body

string

false

Username of who last modified this resource

»» createdDate

body

string(date-time)

false

Date of the created

»» lastModifiedDate

body

string(date-time)

false

Date of the last modified

»» archived

body

boolean

false

Boolean flag indicating archived status

»» externalId

body

string

false

Unique identifier for the external

»» id

body

integer(int64)

false

Unique identifier for the resource

»» name

body

string

false

Name of the resource

»» title

body

string

false

Title of the resource

»» type

body

string

false

Type of the resource

»» description

body

string

false

Description of the resource

»» link

body

string

false

Text value for link in DocumentDto

»» signedDate

body

string(date)

false

Date of the signed

»» documentTypeId

body

integer(int64)

false

Unique identifier for the document type

»» statusId

body

integer(int64)

false

Unique identifier for the status

»» shareable

body

boolean

false

Boolean flag indicating shareable status

»» size

body

integer(int64)

false

Number of items per page

»» documentType

body

PickListOptionDto

false

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»»» createdBy

body

string

false

Username of who created this resource

»»» lastModifiedBy

body

string

false

Username of who last modified this resource

»»» createdDate

body

string(date-time)

false

Date of the created

»»» lastModifiedDate

body

string(date-time)

false

Date of the last modified

»»» archived

body

boolean

false

Boolean flag indicating archived status

»»» externalId

body

string

false

Unique identifier for the external

»»» id

body

integer(int64)

false

Unique identifier for the resource

»»» priority

body

integer(int64)

false

Priority of the resource

»»» internalId

body

integer(int64)

false

Unique identifier for the internal

»»» pickListCode

body

string

false

Code for the pick list

»»» pickListLabel

body

string

false

Label for the pick list

»»» label

body

string

false

Label for the resource

»»» cultureId

body

integer(int64)

false

Unique identifier for the culture

»»» labelDtos

body

[LabelDto]

false

List of labelDtos items

»»»» createdBy

body

string

false

Username of who created this resource

»»»» lastModifiedBy

body

string

false

Username of who last modified this resource

»»»» createdDate

body

string(date-time)

false

Date of the created

»»»» lastModifiedDate

body

string(date-time)

false

Date of the last modified

»»»» archived

body

boolean

false

Boolean flag indicating archived status

»»»» externalId

body

string

false

Unique identifier for the external

»»»» id

body

integer(int64)

false

Unique identifier for the resource

»»»» cultureId

body

integer(int64)

false

Unique identifier for the culture

»»»» value

body

string

true

Text value for value in LabelDto

»» status

body

PickListOptionDto

false

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

Responses

Status

Meaning

Description

Schema

201

Created

Created

DocumentDto

Add Areas To Location

HTTP Request

POST /api/locations/{locationId}/areas

📋 Description: Creates a new area within a specified location in the Nakisa Portfolio Management Suite, enabling enhanced organization and analytics of real estate properties within the portfolio.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

body

body

AreaDto

true

Request body containing the area details, including attributes and metrics relevant to the specified location within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[AreaDto]

false

none

[Data transfer object representing a geographical area within the Nakisa Portfolio Management Suite, encompassing relevant attributes for portfolio analysis, asset management, and real estate property analytics.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» typeId

integer(int64)

true

none

Unique identifier for the type

» unitId

integer(int64)

false

none

Unique identifier for the unit

» sourceId

integer(int64)

false

none

Unique identifier for the source

» proShareTypeId

integer(int64)

false

none

Unique identifier for the pro share type

» documentId

integer(int64)

false

none

Unique identifier for the document

» grossUp

integer(int64)

false

none

Numeric value representing grossUp

» lot

string

false

none

Text value for lot in AreaDto

» cadaster

string

false

none

Text value for cadaster in AreaDto

» name

string

false

none

Name of the resource

» verified

boolean

false

none

Boolean flag indicating verified status

» toBeMeasured

boolean

false

none

Boolean flag indicating toBeMeasured status

» gla

boolean

false

none

Boolean flag indicating gla status

» type

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» priority

integer(int64)

false

none

Priority of the resource

»» internalId

integer(int64)

false

none

Unique identifier for the internal

»» pickListCode

string

false

none

Code for the pick list

»» pickListLabel

string

false

none

Label for the pick list

»» label

string

false

none

Label for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» labelDtos

[LabelDto]

false

none

List of labelDtos items

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» value

string

true

none

Text value for value in LabelDto

» source

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» proShareType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» unitType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

» historiesDto

[AreaHistoryDto]

false

none

List of historiesDto items

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» startDate

string(date)

false

none

Start date of the resource

»» endDate

string(date)

false

none

End date of the resource

»» measure

number

false

none

Value for measure field

»» details

string

false

none

Text value for details in AreaHistoryDto

»» floor

string

false

none

Text value for floor in AreaHistoryDto

»» suite

string

false

none

Text value for suite in AreaHistoryDto

»» areaId

integer(int64)

false

none

Unique identifier for the area

» archivedAssociation

boolean

false

none

none

Get Location References

HTTP Request

GET /api/locations/{id}/references

📋 Description: Retrieves references associated with a specific location within the Nakisa Portfolio Management Suite, providing insights for portfolio and asset analytics in the context of real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the results should be returned in a paginated format, facilitating efficient retrieval of references associated with a specific location within the Nakisa Portfolio Management Suite.

search

query

string

false

Search term used to filter and retrieve specific references related to the asset within the Nakisa Portfolio Management Suite.

number

query

string

false

String representation of the reference number associated with the specified location, used for retrieving analytics and portfolio-related data within the Nakisa Portfolio Management Suite.

department-id

query

string

false

Unique identifier for the department associated with the specified location, used to retrieve relevant portfolio, asset, and analytics data within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelReferenceDto

Add Location References

HTTP Request

POST /api/locations/{id}/references

📋 Description: Creates a new reference entry associated with a specified location within the Nakisa Portfolio Management Suite, enhancing portfolio and asset analytics for real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

ReferenceDto

true

Request body containing the reference data associated with a specific location, including details relevant to portfolio management and asset analytics.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[ReferenceDto]

false

none

[Data transfer object representing a reference entity within the Nakisa Portfolio Management Suite, encompassing key attributes related to portfolio, asset, analytics, and real estate property management.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» number

string

true

none

Text value for number in ReferenceDto

» departmentId

integer(int64)

false

none

Unique identifier for the department

» department

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» priority

integer(int64)

false

none

Priority of the resource

»» internalId

integer(int64)

false

none

Unique identifier for the internal

»» pickListCode

string

false

none

Code for the pick list

»» pickListLabel

string

false

none

Label for the pick list

»» label

string

false

none

Label for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» labelDtos

[LabelDto]

false

none

List of labelDtos items

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» value

string

true

none

Text value for value in LabelDto

Perform Transition

HTTP Request

POST /api/locations/{id}/perform-transition

📋 Description: Initiates a transition for the specified location within the Nakisa Portfolio Management Suite, enabling updates to asset management and analytics related to real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

Transition

true

Request body containing the transition details for a specified location, including asset status updates and relevant analytics for effective portfolio management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[Transition]

false

none

[Data transfer object representing a transition within the Nakisa Portfolio Management Suite, capturing the movement of assets across portfolios to enhance analytics and optimize real estate property management.]

» name

string

false

none

Name of the resource

» from

State

false

none

Data transfer object representing the state of assets within the Nakisa Portfolio Management Suite, providing insights into portfolio performance, asset analytics, and real estate property management. This schema facilitates informed decision-making by capturing the current status and metrics of portfolio components.

»» name

string

false

none

Name of the resource

»» end

boolean

false

none

Boolean flag indicating end status

»» readOnly

boolean

false

none

Boolean flag indicating readOnly status

» to

State

false

none

Data transfer object representing the state of assets within the Nakisa Portfolio Management Suite, providing insights into portfolio performance, asset analytics, and real estate property management. This schema facilitates informed decision-making by capturing the current status and metrics of portfolio components.

» permission

string

false

none

Text value for permission in Transition

Enumerated Values

Attribute

Value

name

ACTIVATE, ACTIVE, APPROVE, APPROVED, AWAITING_ACTIVATION, DEACTIVATE, DRAFT, INACTIVE, OPEN_FOR_MODIFICATIONS, PENDING_APPROVAL, PENDING_TERMINATE, PENDING_TERMINATION, REJECT, SEND_FOR_APPROVAL, TERMINATE, TERMINATED

Archive Location

HTTP Request

POST /api/locations/{id}/archive

📋 Description: Archives a specified location within the Nakisa Portfolio Management Suite, enabling effective management of real estate assets and enhancing portfolio analytics.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

LocationDto

Get Image

HTTP Request

GET /api/locations/{locationId}/pictures/{pictureId}/download

📋 Description: Downloads the specified picture associated with a location within the Nakisa Portfolio Management Suite, facilitating access to visual assets for portfolio and asset analysis in real estate management.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

pictureId

path

integer(int64)

true

Unique identifier for the picture

Responses

Status

Meaning

Description

Schema

200

OK

OK

string

Get Operating Cost Expense Types For Location

HTTP Request

GET /api/locations/{locationId}/operating-cost-expense-types

📋 Description: Retrieves the operating cost expense types associated with a specific location, enabling users to analyze and manage financial aspects of real estate properties within the Nakisa Portfolio Management Suite.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[OperatingCostExpenseTypeDto]

false

none

[Data transfer object representing the classification of operating cost expenses associated with real estate properties within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset analytics.]

» createdBy

string

false

none

Username of who created this resource

» lastModifiedBy

string

false

none

Username of who last modified this resource

» createdDate

string(date-time)

false

none

Date of the created

» lastModifiedDate

string(date-time)

false

none

Date of the last modified

» archived

boolean

false

none

Boolean flag indicating archived status

» externalId

string

false

none

Unique identifier for the external

» id

integer(int64)

false

none

Unique identifier for the resource

» operatingCostExpenseTypeId

integer(int64)

false

none

Unique identifier for the operating cost expense type

» expenseGroupId

integer(int64)

false

none

Unique identifier for the expense group

» operatingCostExpenseTypeOption

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and managing portfolio assets and analytics in the Nakisa Portfolio Management Suite, particularly in the context of real estate property management.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Boolean flag indicating archived status

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» priority

integer(int64)

false

none

Priority of the resource

»» internalId

integer(int64)

false

none

Unique identifier for the internal

»» pickListCode

string

false

none

Code for the pick list

»» pickListLabel

string

false

none

Label for the pick list

»» label

string

false

none

Label for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» labelDtos

[LabelDto]

false

none

List of labelDtos items

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Boolean flag indicating archived status

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» value

string

true

none

Text value for value in LabelDto

Location Has Active Child

HTTP Request

GET /api/locations/{locationId}/has-active-child

📋 Description: Retrieves a boolean value indicating whether the specified location has any active child assets within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management in real estate analytics.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

Responses

Status

Meaning

Description

Schema

200

OK

OK

boolean

Download Location Document

HTTP Request

GET /api/locations/{locationId}/documents/{documentId}/download

📋 Description: Downloads the specified document associated with a particular location within the Nakisa Portfolio Management Suite, facilitating access to critical asset and portfolio information for real estate analytics.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

documentId

path

integer(int64)

true

Unique identifier for the document

Responses

Status

Meaning

Description

Schema

200

OK

OK

StreamingResponseBody

Get Location Access Level

HTTP Request

GET /api/locations/{locationId}/authorization

📋 Description: Retrieves authorization details for a specified location within the Nakisa Portfolio Management Suite, enabling users to manage portfolio and asset access for real estate properties effectively.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

Responses

Status

Meaning

Description

Schema

200

OK

OK

PickListOptionDto

Get Transitions

HTTP Request

GET /api/locations/{id}/transitions

📋 Description: Retrieves the transition history for a specified location within the Nakisa Portfolio Management Suite, providing insights into asset movements and changes relevant to portfolio and real estate analytics.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[Transition]

false

none

[Data transfer object representing a transition within the Nakisa Portfolio Management Suite, capturing the movement of assets across portfolios to enhance analytics and optimize real estate property management.]

» name

string

false

none

Name of the resource

» from

State

false

none

Data transfer object representing the state of assets within the Nakisa Portfolio Management Suite, providing insights into portfolio performance, asset analytics, and real estate property management. This schema facilitates informed decision-making by capturing the current status and metrics of portfolio components.

»» name

string

false

none

Name of the resource

»» end

boolean

false

none

Boolean flag indicating end status

»» readOnly

boolean

false

none

Boolean flag indicating readOnly status

» to

State

false

none

Data transfer object representing the state of assets within the Nakisa Portfolio Management Suite, providing insights into portfolio performance, asset analytics, and real estate property management. This schema facilitates informed decision-making by capturing the current status and metrics of portfolio components.

» permission

string

false

none

Text value for permission in Transition

Enumerated Values

Attribute

Value

name

ACTIVATE, ACTIVE, APPROVE, APPROVED, AWAITING_ACTIVATION, DEACTIVATE, DRAFT, INACTIVE, OPEN_FOR_MODIFICATIONS, PENDING_APPROVAL, PENDING_TERMINATE, PENDING_TERMINATION, REJECT, SEND_FOR_APPROVAL, TERMINATE, TERMINATED

Get Location Reminders

HTTP Request

GET /api/locations/{id}/reminders

📋 Description: Fetches reminders associated with a specific location within the Nakisa Portfolio Management Suite, enabling users to manage portfolio and asset-related notifications effectively.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the results of the reminders associated with a specific location should be returned in a paginated format, facilitating efficient data retrieval for portfolio and asset management analytics.

subject-id

query

string

false

Unique identifier for the subject associated with reminders in the context of portfolio management and asset analytics.

category-id

query

string

false

Unique identifier for the category of reminders associated with a specific location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

lease-id

query

string

false

Unique identifier for the lease associated with the specified location, enabling retrieval of relevant reminders within the Nakisa Portfolio Management Suite.

lease-id-in

query

string

false

Unique identifier for the lease associated with the specified location, used to retrieve relevant reminders within the Nakisa Portfolio Management Suite.

status-id

query

string

false

Unique identifier for the status of reminders associated with a specific location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

status-id-in

query

string

false

Specifies the unique status identifier for reminders associated with a particular location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

reminder-type-id

query

string

false

Unique identifier for the type of reminder associated with a specific location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

reminder-type-id-in

query

string

false

Unique identifier for the type of reminder associated with a specific location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management.

date

query

string

false

Date of the resource

follow-up-date

query

string

false

Specifies the date for follow-up reminders related to the selected location’s portfolio assets within the Nakisa Portfolio Management Suite.

follow-up-date-before

query

string

false

Specifies the cutoff date for retrieving reminders related to a particular location, enabling users to focus on upcoming follow-up actions within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelReminderDto

Get Location Premises

HTTP Request

GET /api/locations/{id}/premises

📋 Description: Retrieves a list of premises associated with a specific location, providing valuable insights for portfolio and asset management within the Nakisa Portfolio Management Suite.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the results of the premises associated with a specific location should be returned in a paginated format, facilitating efficient data retrieval for portfolio and asset management analytics.

search

query

string

false

Search term used to filter and retrieve specific premises associated with a given location within the Nakisa Portfolio Management Suite.

city-id

query

string

false

Unique identifier for the city associated with the premises, used to retrieve relevant asset and portfolio analytics within the Nakisa Portfolio Management Suite.

province-id

query

string

false

Unique identifier for the province associated with the specified premises, facilitating precise asset and portfolio analytics within the Nakisa Portfolio Management Suite.

country-id

query

string

false

Unique identifier for the country associated with the specified premises, facilitating accurate portfolio and asset analytics within the Nakisa Portfolio Management Suite.

city-id-in

query

string

false

Unique identifier for the city associated with the specified premises, facilitating targeted analytics and insights within the Nakisa Portfolio Management Suite.

province-id-in

query

string

false

Unique identifier for the province associated with the specified location, used to filter premises data within the Nakisa Portfolio Management Suite.

country-id-in

query

string

false

Specifies the unique identifier for the country associated with the premises being queried in the Nakisa Portfolio Management Suite, facilitating accurate portfolio and asset analytics within real estate property management.

id-in

query

string

false

Unique identifier for the specific location within the Nakisa Portfolio Management Suite, used to retrieve associated premises data for portfolio and asset analytics.

legal-entity-id-in

query

string

false

Unique identifier for the legal entity associated with the specified premises, facilitating accurate portfolio and asset management within the Nakisa Portfolio Management Suite.

location-id

query

string

false

Unique identifier for the specific location within the Nakisa Portfolio Management Suite, used to retrieve associated premises data for portfolio and asset analysis in real estate management.

location-type-id

query

string

false

Identifier for the type of location associated with the specified premises, facilitating portfolio and asset analytics within the Nakisa Portfolio Management Suite.

location-id-in

query

string

false

Unique identifier for the specific location within the Nakisa Portfolio Management Suite, used to retrieve associated premises data for portfolio and asset analytics.

location-number-like

query

string

false

Specifies a string pattern to filter premises associated with a location in the Nakisa Portfolio Management Suite, enhancing analytics and asset management within real estate portfolios.

location-external-id

query

string

false

Unique identifier for the external location associated with the premises, facilitating accurate asset and portfolio analytics within the Nakisa Portfolio Management Suite.

external-id-like

query

string

false

Specifies a string pattern to filter premises by their external identifiers, facilitating targeted asset management and analytics within the Nakisa Portfolio Management Suite.

number

query

string

false

Specifies the unique identifier for the location’s premises within the Nakisa Portfolio Management Suite, facilitating asset and portfolio analytics in real estate property management.

number-like

query

string

false

Represents a numeric value or identifier related to the premises within a specified location in the Nakisa Portfolio Management Suite, facilitating asset and portfolio analytics.

name

query

string

false

Name of the resource

name-like

query

string

false

Filters the list of premises associated with the specified location by matching names that are similar to the provided string, enhancing asset management and analytics within the real estate portfolio.

head-premise

query

string

false

Specifies the head premise associated with a particular location, enabling effective portfolio and asset management within the Nakisa Portfolio Management Suite.

possession-date

query

string

false

Specifies the date of possession for the premises, enabling accurate tracking and analysis of real estate property assets within the portfolio.

opening-date

query

string

false

Specifies the opening date of the premises associated with the given location, facilitating portfolio and asset analysis within the Nakisa Portfolio Management Suite.

closing-date

query

string

false

Specifies the closing date for the premises associated with the given location, facilitating accurate portfolio and asset analysis within the Nakisa Portfolio Management Suite.

relocation-date

query

string

false

Specifies the date of relocation for the premises, enabling accurate portfolio and asset analytics within the Nakisa Portfolio Management Suite.

vacating-date

query

string

false

Specifies the date on which the premises will be vacated, facilitating accurate portfolio and asset management within the Nakisa Portfolio Management Suite.

expansion-date

query

string

false

Specifies the date for which the premises data is being requested, enabling users to analyze portfolio and asset performance within the Nakisa Portfolio Management Suite.

status-id

query

string

false

Unique identifier for the status of premises associated with a specific location, facilitating effective portfolio and asset management within the Nakisa Portfolio Management Suite.

status-id-in

query

string

false

Specifies the status ID to filter premises associated with a given location, enabling targeted analytics within the Nakisa Portfolio Management Suite.

usage-id

query

string

false

Unique identifier for the specific usage instance within the portfolio, enabling retrieval of premises data associated with a real estate property.

parent-premise-id

query

string

false

Unique identifier for the parent premise within the Nakisa Portfolio Management Suite, used to retrieve associated premises for effective portfolio and asset analysis in real estate management.

contract-id-not-null

query

string

false

Identifier for the contract associated with the specified location, ensuring that only premises linked to valid contracts are retrieved for portfolio and asset analysis.

master-agreement-id-in

query

string

false

Unique identifier for the master agreement associated with the specified location, facilitating effective portfolio and asset management within the Nakisa Portfolio Management Suite.

business-unit-id-in

query

string

false

Unique identifier for the business unit associated with the specified location, used to filter premises data within the Nakisa Portfolio Management Suite.

group-id-in

query

string

false

Unique identifier for the group associated with the specified location, used to filter premises data within the Nakisa Portfolio Management Suite.

contract-id-in

query

string

false

Unique identifier for the specific contract associated with the premises, facilitating precise portfolio and asset analytics within the Nakisa Portfolio Management Suite.

head-premise-opt

query

string

false

Specifies the head premise option for retrieving detailed information about a specific location’s premises within the Nakisa Portfolio Management Suite, facilitating enhanced portfolio and asset analytics in real estate property management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelPremiseDto

Get Partners For Location

HTTP Request

GET /api/locations/{id}/partners

📋 Description: Retrieves a list of partners associated with a specific location within the Nakisa Portfolio Management Suite, enabling users to analyze collaborative relationships in the context of portfolio and asset management.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the response should be paginated, allowing users to efficiently retrieve partner information related to a specific location within the Nakisa Portfolio Management Suite.

partner-id

query

string

false

Unique identifier for the partner associated with a specific location, facilitating portfolio and asset analytics within the Nakisa Portfolio Management Suite.

partner-role-id

query

string

false

Unique identifier for the partner role associated with a specific location, facilitating effective portfolio and asset management within the Nakisa Portfolio Management Suite.

partner-role-id-in

query

string

false

Unique identifier for the partner role associated with a specific location, facilitating targeted analytics and management within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelLocationToPartnerDto

Get Notes For Location

HTTP Request

GET /api/locations/{id}/notes

📋 Description: Retrieves notes associated with a specific location within the Nakisa Portfolio Management Suite, enabling users to access critical insights related to portfolio and asset management for real estate properties.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the results of the notes associated with a specific location should be returned in a paginated format, facilitating efficient data retrieval for portfolio and asset management within the Nakisa Portfolio Management Suite.

search

query

string

false

Search term used to filter notes associated with a specific location within the Nakisa Portfolio Management Suite, enhancing asset and portfolio analytics.

message

query

string

false

Textual content of the note associated with the specified location, providing insights relevant to portfolio and asset management within the Nakisa Portfolio Management Suite.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelNoteDto

Get Areas For Location

HTTP Request

GET /api/locations/{id}/areas

📋 Description: Retrieves a list of areas associated with a specific location within the Nakisa Portfolio Management Suite, enabling users to analyze and manage real estate properties effectively.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the results of the area retrieval for a specific location should be paginated, facilitating efficient data management within the Nakisa Portfolio Management Suite.

search

query

string

false

Search term used to filter and retrieve specific areas within a location in the Nakisa Portfolio Management Suite, enhancing portfolio and asset analytics for real estate properties.

type-id

query

string

false

Unique identifier for the type of area associated with a specific location, facilitating targeted analytics within the Nakisa Portfolio Management Suite.

unit-id

query

string

false

Unique identifier for the specific unit within the Nakisa Portfolio Management Suite, used to retrieve associated areas relevant to portfolio and asset analytics in real estate property management.

source-id

query

string

false

Unique identifier for the source of the location data, facilitating precise retrieval of area information within the Nakisa Portfolio Management Suite.

pro-share-type-id

query

string

false

Unique identifier for the type of profit-sharing arrangement associated with the specified location’s areas within the Nakisa Portfolio Management Suite.

document-id

query

string

false

Unique identifier for the specific document associated with the real estate property within the Nakisa Portfolio Management Suite, facilitating targeted retrieval of area data.

gross-up

query

string

false

Specifies the gross-up value for calculating adjusted financial metrics related to real estate properties within the portfolio.

lot

query

string

false

Specifies the lot associated with the real estate property to retrieve area details within the Nakisa Portfolio Management Suite.

cadaster

query

string

false

Identifier for the cadaster associated with the specified location, used to retrieve detailed area information within the Nakisa Portfolio Management Suite for effective asset and portfolio analytics.

verified

query

string

false

Indicates whether the areas associated with the specified location have been verified, providing essential insights for portfolio and asset management within the Nakisa Portfolio Management Suite.

to-be-measured

query

string

false

Specifies the area to be measured within the real estate property portfolio, enabling targeted analytics and asset management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedModelEntityModelAreaDto

Get Default Location

HTTP Request

GET /api/locations/default/{userId}

📋 Description: Retrieves the default location settings for a specified user within the Nakisa Portfolio Management Suite, facilitating enhanced portfolio and asset management for real estate properties.

Parameters

Name

In

Type

Required

Description

userId

path

integer(int64)

true

Unique identifier for the user

Responses

Status

Meaning

Description

Schema

200

OK

OK

LocationDto

Delete Location Picture

HTTP Request

DELETE /api/locations/{locationId}/pictures/{pictureId}

📋 Description: Deletes a specified picture associated with a location within the Nakisa Portfolio Management Suite, facilitating the management of visual assets related to real estate properties.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

pictureId

path

integer(int64)

true

Unique identifier for the picture

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

None

Delete Location Document

HTTP Request

DELETE /api/locations/{locationId}/documents/{documentId}

📋 Description: Deletes a specified document associated with a particular location within the Nakisa Portfolio Management Suite, facilitating the management of portfolio-related assets and enhancing data accuracy in real estate property analytics.

Parameters

Name

In

Type

Required

Description

locationId

path

integer(int64)

true

Unique identifier for the location

documentId

path

integer(int64)

true

Unique identifier for the document

Responses

Status

Meaning

Description

Schema

200

OK

OK

None

Delete Location Second Address

HTTP Request

DELETE /api/locations/{id}/second-address

📋 Description: Deletes the secondary address associated with a specified location in the Nakisa Portfolio Management Suite, streamlining asset management and enhancing data accuracy within real estate property portfolios.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

None

Delete Location Group

HTTP Request

DELETE /api/locations/{id}/groups/{groupId}

📋 Description: Deletes a specified group from a location within the Nakisa Portfolio Management Suite, facilitating effective portfolio and asset management by allowing users to maintain accurate and organized real estate property data.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

groupId

path

integer(int64)

true

Unique identifier for the group

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

LocationDto