Skip to content

List buildings

Request

Returns a filtered and paginated list of buildings within the current account context.

Behavior:

  • Applies filtering criteria from the request body
  • Supports pagination using the start query parameter
  • Retrieves buildings accessible to the current user
  • Returns structured building list response data
  • Logs the action as building grid view
Query
startstring
Body
siteIdsArray of strings or null, (uuid)
buildingIdsArray of strings or null, (uuid)
levelIdsArray of strings or null, (uuid)
roomIdstring or null
assetClassIdstring or null
assetTypeIdstring or null
assignedboolean
unassignedboolean
datafieldIdsArray of strings or null
selectedIdsArray of strings or null
statusArray of strings or null
isEquipmentWithSpaceHandleboolean
includeFurnitureboolean or null
levelNamestring or null
levelPositioninteger, (int32)
fieldValuesArray of objects or null(zLink.Business.zOne.Base.Common.EntityDataFieldValue)
isAdvancedSearchboolean or null
isLinkAssetboolean
assetClassIdsArray of strings or null, (uuid)
assetTypeIdsArray of strings or null, (uuid)
keywordstring or null
sortColumnstring or null
sortColumnIdstring or null, (uuid)
sortOrderstring or null
filterstring or null
curl -i -X POST \
  'https://demozone.zlinkfm.com/RND/api/v1/portfolio/locations/buildings/list?start=string' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
    "siteIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "buildingIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "levelIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "roomId": "string",
    "assetClassId": "string",
    "assetTypeId": "string",
    "assigned": true,
    "unassigned": true,
    "datafieldIds": [
      "string"
    ],
    "selectedIds": [
      "string"
    ],
    "status": [
      "string"
    ],
    "isEquipmentWithSpaceHandle": true,
    "includeFurniture": true,
    "levelName": "string",
    "levelPosition": 0,
    "fieldValues": [
      {
        "dataFieldId": "b6507240-6286-4e43-b3da-bd23ecf1c322",
        "dataFieldValue": "string",
        "dataFieldlabel": "string",
        "dataFieldValueIds": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "fromDate": "string",
        "toDate": "string",
        "dataFieldValueRangeType": "string"
      }
    ],
    "isAdvancedSearch": true,
    "isLinkAsset": true,
    "assetClassIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "assetTypeIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "keyword": "string",
    "sortColumn": "string",
    "sortColumnId": "0f49f070-9ddb-4e23-bac3-3a9c7797ab4e",
    "sortOrder": "string",
    "filter": "string"
  }'

Responses

OK

Body
dataobject(zLink.Business.zOne.Portfolio.ResponseModels.BuildingListResponseModel)
messagestring or null
isErrorboolean
messageCodeinteger, (int32)
statusstring or null
errorTypestring or null
traceidstring or null
responseDescriptionstring or null
Response
{
  "data": {
    "generalProperties": [
      {
        "name": "string",
        "alias": "string",
        "dataType": "string",
        "propertyType": "string",
        "isKeyData": true,
        "visibility": true,
        "dataFieldId": "b6507240-6286-4e43-b3da-bd23ecf1c322",
        "uiProperties": {
          "fullWidth": true,
          "columnWidth": "string",
          "columnSpan": 0
        }
      }
    ],
    "data": [
      {
        "buildingName": "string",
        "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
        "buildingDescription": "string",
        "buildingType": "string",
        "location": {
          "locationName": "string",
          "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
          "status": {
            "statusId": "e900225c-0629-4e96-be6e-86a17a309645",
            "statusCode": "string",
            "statusName": "string",
            "statusColor": "string"
          }
        },
        "additionalInfo": [
          {
            "dataField": "string",
            "dataFieldId": "b6507240-6286-4e43-b3da-bd23ecf1c322",
            "dataIds": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ],
            "dataFieldValue": null,
            "dataFieldName": "string",
            "dataValueFormated": "string"
          }
        ],
        "status": {
          "statusId": "e900225c-0629-4e96-be6e-86a17a309645",
          "statusCode": "string",
          "statusName": "string",
          "statusColor": "string"
        },
        "cadPlans": [
          {
            "planId": "b3f60ba2-c1fd-4b3a-a23d-8e876e0ef75d",
            "planType": {
              "planTypeId": "0516887d-9268-43c8-b82e-1501d9714a9a",
              "planTypeName": "string"
            },
            "planDescription": "string",
            "planModel": {
              "planModelId": "9eed1a98-11cb-4f43-8459-1812e5594dc9",
              "planModelName": "string"
            },
            "planFile": {
              "fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc",
              "fileName": "string",
              "fileSize": "string",
              "currentRevisionNumber": 0,
              "createdOn": "string",
              "fileSizeInBytes": 0,
              "createdDate": "2019-08-24T14:15:22Z",
              "createdBy": "string",
              "isLatest": true
            },
            "revisions": [
              {}
            ],
            "locationInfo": {
              "location": "string",
              "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
              "building": "string",
              "buildingId": "fee3295a-6e55-45b0-a091-7b4de7e39de7",
              "level": "string",
              "levelId": "a70368c7-b12e-43a9-9830-ab2485710b95",
              "room": "string",
              "roomId": "c3631f02-ff67-42b8-8775-18c47f52a678",
              "workspace": "string",
              "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c",
              "spaceKey": "string",
              "spaceAssignedOn": "string",
              "spaceCategory": {},
              "roomFunction": {},
              "spaceArea": 0.1,
              "levelPlanHandle": "string",
              "employeeLocationId": "2e9ca96c-a4c6-4bdb-b2bb-33d9e60c3f1c",
              "rollBackInfo": {},
              "levelPlanId": "0f5a21ff-233b-4dbc-8296-4521bcd60dc1",
              "planFile": {},
              "cadPlanCoordinates": [
                null
              ],
              "spaceAssignedOnDateTimeFormat": "string",
              "svgPlanAdded": true
            },
            "assetIds": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ],
            "svgPlanAdded": true,
            "responseDescription": "string",
            "hasAnyRevisions": true,
            "isPlanRemoved": true,
            "responseMessage": "string",
            "isCadPlanExist": true
          }
        ],
        "noOfFloors": 0,
        "noOfActiveFloors": 0,
        "ownershipType": {
          "ownershipTypeId": 0,
          "uniqueId": "a1e12d74-d756-40d1-9bb3-519def353f44",
          "ownershipTypeName": "string",
          "ownershipTypeCode": "string"
        },
        "buildingArea": 0.1,
        "buildingAreaText": "string",
        "isCadPlanExist": true,
        "latLong": [
          0.1
        ],
        "latitude": 0.1,
        "longitude": 0.1
      }
    ],
    "listProperties": {
      "totalCount": 0,
      "currentStart": 0,
      "currentLength": 0,
      "pageCount": 0
    }
  },
  "message": "string",
  "isError": true,
  "messageCode": 0,
  "status": "string",
  "errorType": "string",
  "traceid": "string",
  "responseDescription": "string"
}