Get Apartment Entity detailed information
Returns Apartment Entity detailed information.
Base Apartment Entity properties:
- apartment logical address
- apartment name
- link_id
Additional linked properties:
- identifiers count and UIDs
- input numbers count and UIDs
- forward UIDs
Path Parameters
- apartmentUid integer requiredPossible values: >= 1Unique Identifier for Apartment Item 
- 200
- 400
- 401
- 403
OK
- application/json
- Schema
- Example (from schema)
- Example
- Example A A-14
Schema
- apartment_address object- Logical address - an entity defines the device/user address in the address hierarchy and is used during a call, issuing identifiers, creating call forwarding rules etc. building integer- Possible values: - >= 1and- <= 9999- Building number unit integer- Possible values: - <= 99- Unit number floor integer- Possible values: - <= 98- Floor number room integer- Possible values: - <= 99- Room number 
- apartment_name stringPossible values: Value must match regular expression ^\S(.*\S)?$Name for the apartment, owner full name or apartment number usually used. Nonempty string without leading and trailing spaces 
- residents object- Optional information about tenants count integer- The number living in the apartment 
- photo_path stringPhoto path for person photo in apartment book Available only on AA-14 
- route_path stringRoute image for lift feature. Available only on AA-14 
- identifiers object- Types of associated identifiers (cards, codes, etc.) - physicals: card, UKEY, face_id - input_numbers: code entered on the keyboard - physicals object- Model used to providing array of UIDs of various enumerated entities stored in the panel, such as apartments, identifiers, forward, and similar uid_items integer[]- Possible values: - >= -1- Array of UID for entities referenses. link_ids uuid[]- Array of LinkIDs for entities references count integer- The number of values in the array - input_numbers object- Model used to providing array of UIDs of various enumerated entities stored in the panel, such as apartments, identifiers, forward, and similar uid_items integer[]- Possible values: - >= -1- Array of UID for entities referenses. link_ids uuid[]- Array of LinkIDs for entities references count integer- The number of values in the array 
- forward objectexist booleanuid_item integer- Possible values: - >= -1- UID for entities referenses. If value is - -1, then it means that is no entity reference for this structure
- link_id uuidUnique entity set by the server to bind some parameters with each other. By default return null value 
- tenants object[]name stringid integerowner_type string
{
  "apartment_address": {
    "building": 1,
    "unit": 1,
    "floor": 1,
    "room": 1
  },
  "apartment_name": "221B Baker Street",
  "residents": {
    "count": 3
  },
  "photo_path": "/files?imagePath=apartment-1-1-1-1.jpg",
  "route_path": "/files?imagePath=route-1-1-1-1.webp",
  "identifiers": {
    "physicals": {
      "uid_items": [
        11,
        13,
        23,
        42
      ],
      "link_ids": [
        "91c615e3-1040-4815-8ecb-039a18b756b1",
        "91c615e3-1040-4815-8ecb-039a18b756b2",
        "91c615e3-1040-4815-8ecb-039a18b756b3",
        "91c615e3-1040-4815-8ecb-039a18b756b4"
      ],
      "count": 4
    },
    "input_numbers": {
      "uid_items": [
        11,
        13,
        23,
        42
      ],
      "link_ids": [
        "91c615e3-1040-4815-8ecb-039a18b756b1",
        "91c615e3-1040-4815-8ecb-039a18b756b2",
        "91c615e3-1040-4815-8ecb-039a18b756b3",
        "91c615e3-1040-4815-8ecb-039a18b756b4"
      ],
      "count": 4
    }
  },
  "forward": {
    "exist": true,
    "uid_item": 3
  },
  "link_id": "91c615e3-1040-4815-8ecb-039a18b756b5",
  "tenants": [
    {
      "name": "John Doe",
      "id": 1,
      "owner_type": "owner"
    }
  ]
}
{
  "apartment_address": {
    "building": 1,
    "unit": 1,
    "floor": 1,
    "room": 1
  },
  "apartment_name": "221B Baker Street",
  "link_id": "8e4c043b-12f8-4863-81b5-529727f6bf6e",
  "residents": {
    "count": 3
  },
  "identifiers": {
    "physicals": {
      "count": 4,
      "uid_items": [
        11,
        13,
        23,
        42
      ],
      "link_ids": [
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e"
      ]
    },
    "input_numbers": {
      "count": 4,
      "uid_items": [
        11,
        13,
        23,
        42
      ],
      "link_ids": [
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e"
      ]
    }
  },
  "forward": {
    "exist": true,
    "uid_item": 3
  }
}
{
  "apartment_address": {
    "building": 1,
    "unit": 1,
    "floor": 1,
    "room": 1
  },
  "apartment_name": "221B Baker Street",
  "residents": {
    "count": 3
  },
  "photo_path": "/files?imagePath=apartment-1-1-1-1.jpg",
  "route_path": "/files?imagePath=route-1-1-1-1.webp",
  "link_id": "8e4c043b-12f8-4863-81b5-529727f6bf6e",
  "identifiers": {
    "physicals": {
      "uid_items": [
        11,
        13,
        23,
        42
      ],
      "count": 4,
      "link_ids": [
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e"
      ]
    },
    "input_numbers": {
      "uid_items": [
        11,
        13,
        23,
        42
      ],
      "count": 4,
      "link_ids": [
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e",
        "8e4c043b-12f8-4863-81b5-529727f6bf6e"
      ]
    }
  },
  "forward": {
    "exist": true,
    "uid_item": 3
  }
}
Provided wrong apartmentUid
- application/json
- Schema
- Example (from schema)
- Wrong uid
Schema
- error string
{
  "error": "Wrong Logical Address"
}
{
  "error": "Wrong apartment uid"
}
Unauthorized request. Log In
- application/json
- Schema
- Example (from schema)
- Log In
Schema
- error string
{
  "error": "Log In"
}
{
  "error": "Log In"
}
Administrator rights required. You are currently logged in with different user account. Log In with administrator rights
- application/json
- Schema
- Example (from schema)
- Admin Rights Required
Schema
- error string
{
  "error": "Administrator rights required"
}
{
  "error": "Administrator rights required"
}