Get multiple User Entities with link_id

Returns multiple User Entities with link_id with filter, sort and pagination options.

Query Parameters

• limit integer

  Possible values: [10, 20, 30, 50]

  Number of items. Value by default is 10

• page_number integer

  Possible values: >= 1

  Page number

• sort_field string

  Field name (JSON Key in item entity)

• sort_type string

  Possible values: [asc, desc]

  Default value: asc

  Sort type (asc/desc)

• filter object

  Filtering options for Identifiers

Responses

• 200
• 401
• 403

---

OK

application/json

• Schema
• Example (from schema)
• Example

---

Schema

• list_option object

  This model provides the options can be used to sort, filter and pagination when getting list of users

  pagination object

  Available pagination options for tables

  total_items integer

  The total number of items found and reflected across all pages

  items_limit integer

  Possible values: [10, 25, 50]

  Limiting the display of the amount of data for one page

  total_pages integer

  Possible values: >= 1

  The number of pages that hold the requested data

  current_page integer

  Possible values: >= 1

  Current page number

  filter object

  Available filter sets for user

  oneOf

  • MOD1
  • MOD2

  ---

  filter_field string

  Field available for filtering

  filter_type string

  Possible values: [equal]

  Available filtering type, only equal here

  filter_format string

  Data format, only string here

  filter_value string

  Identifier name

  filter_field string

  Field available for filtering

  filter_type string

  Possible values: [equal]

  Available filtering type, only equal here

  filter_format string

  Data format, only string here

  filter_value string

  Identifier name

  sort object

  Available sorting options for the users table

  field string

  Sorting field name

  asc boolean

  Direction of sorting

  available_fields string[]

  Available for sorting fields names

• list_items object[]

{
  "list_option": {
    "pagination": {
      "total_items": 18,
      "items_limit": 10,
      "total_pages": 2,
      "current_page": 1
    },
    "filter": {
      "filter_field": "name",
      "filter_type": "equal",
      "filter_format": "string",
      "filter_value": "Sherlock Holmes"
    },
    "sort": {
      "field": "name",
      "asc": true,
      "available_fields": [
        "name"
      ]
    }
  },
  "list_items": [
    {
      "link_id": "91c615e3-1040-4815-8ecb-039a18b756b5",
      "identifiers": {
        "link_ids": [
          "91c615e3-1040-4815-8ecb-039a18b756b5"
        ]
      },
      "apartments": {
        "link_id": "a57a5e0b-09d3-4818-a4dc-fee7670660e4",
        "owner_type": "guest"
      },
      "timeprofiles": {
        "link_ids": [
          "91c615e3-1040-4815-8ecb-039a18b756b5"
        ]
      },
      "name": "John Doe",
      "item_uid": 0,
      "lock_number": 1,
      "is_custom_user_access": false,
      "auth_factors": [
        "card"
      ],
      "info": "Employee"
    }
  ]
}

{
  "list_option": {
    "pagination": {
      "total_items": 18,
      "items_limit": 10,
      "total_pages": 2,
      "current_page": 1
    },
    "filter": {
      "filter_field": "name",
      "filter_type": "equal",
      "filter_format": "string",
      "filter_value": "Sherlock Holmes",
      "available_filtering": true,
      "available_fields": [
        "name",
        "info"
      ],
      "is_filtered": true
    },
    "sort": {
      "field": "name",
      "asc": true,
      "available_fields": [
        "name"
      ]
    }
  },
  "list_items": [
    {
      "item_uid": 0,
      "name": "John Doe",
      "info": "Employee",
      "auth_factors": [
        "face_id",
        "card"
      ],
      "lock_number": 1,
      "is_custom_user_access": false,
      "apartments": {
        "link_ids": [
          "91c615e3-1040-4815-8ecb-039a18b756b1",
          "91c615e3-1040-4815-8ecb-039a18b756b2"
        ]
      },
      "identifiers": {
        "link_ids": [
          "91c615e3-1040-4815-8ecb-039a18b756b1",
          "91c615e3-1040-4815-8ecb-039a18b756b2"
        ]
      },
      "timeprofiles": {
        "link_ids": [
          "91c615e3-1040-4815-8ecb-039a18b756b1",
          "91c615e3-1040-4815-8ecb-039a18b756b2"
        ]
      },
      "link_id": "91c615e3-1040-4815-8ecb-039a18b756b1"
    }
  ]
}

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"
}

Loading...