Get logs list

Return log's list. Available events:

Access

access_denied_by_not_valid_identifier
access_denied_by_not_valid_face_identifier
access_denied_by_not_valid_input_code
access_denied_by_remote_server_api_call
access_denied_by_unknown_card
access_granted_by_api_call
access_granted_by_call_host
access_granted_by_master_code
access_granted_by_remote_server_api_call
access_granted_by_valid_identifier
access_granted_by_valid_face_identifier
door_was_closed
access_denied_unknown_identifier
door_sensor_was_closed
door_was_opened
door_sensor_was_opened
emergency_lock_is_opened
lock_was_opened_by_exit_btn
lock_was_opened_by_free_access_button
multi_access_granted
identifiers_without_linkage_to_user_access_denied
multi_access_denied
lift_call_success
lift_call_error
lift_module_access_error
access_granted_by_shared_identifier
access_denied_by_not_valid_shared_identifier
bond_lift_request

Info

incoming_call
outgoing_call
outgoing_call_missed
device_booted
sip_registration_lost
outgoing_call_web

System

incorrect_login_api_call
incorrect_login_gui_settings
successful_login_api_call
successful_login_gui_settings

Emergency

door_was_not_closed_too_long
tamper_event

Query Parameters

locale string
Possible values: [en, es, ru, uk, pl, nl, tr, fr, da]
Default value: en
Language for localizing logs. Value by default is 'en'
- English (en)
- Spanish (es)
- French (fr)
- Danish (da)
- Dutch (nl)
- Ukrainian (uk)
- Turkish (tr)
- Polish (pl)
- Russian (ru)
from int64
Unix time used to get entities in a specific time window.
- Used in conjunction with timeTo param
to int64
Unix time used to get entities in a specific time window.
- Used in conjunction with timeFrom param
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_type string
Possible values: [asc, desc]
Default value: asc
Sort type (asc/desc)
filter object
Filtering options for Logs

Responses

application/json

Schema
Example (from schema)
Logs with options

Schema

list_option object
The model provides options can be used to sort, filter, and paginate log items
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, 20, 30, 50]
Limiting the display of the amount of data for one page
total_pages integer
The number of pages that hold the requested data
current_page integer
Possible values: >= 1
Current page number
filter object
This model describes available filter options can be used to display logs
available_filtering boolean
Is filtering available
is_filtered boolean
Is data filtered
available_fields object[]
Available fields
available_values object
List of available filter options
category string[]
Possible values: [access, emergency, system, info]
List of categories
priority string[]
Possible values: [critical, high, low, medium]
Log priority
name object[]
Log name
text string
Log description
key string
Possible values: [access_denied_by_not_valid_identifier, access_denied_by_not_valid_face_identifier, access_denied_by_not_valid_input_code, access_denied_by_remote_server_api_call, access_denied_by_unknown_card, access_granted_by_api_call, access_granted_by_call_host, access_granted_by_master_code, access_granted_by_remote_server_api_call, access_granted_by_valid_identifier, access_granted_by_valid_face_identifier, door_was_closed, door_sensor_was_closed, door_was_opened, door_sensor_was_opened, emergency_lock_is_opened, lock_was_opened_by_exit_btn, lock_was_opened_by_free_access_button, incoming_call, outgoing_call, outgoing_call_missed, device_booted, sip_registration_lost, outgoing_call_web, incorrect_login_api_call, incorrect_login_gui_settings, successful_login_api_call, successful_login_gui_settings, door_was_not_closed_too_long, multi_access_granted, identifiers_without_linkage_to_user_access_denied, multi_access_denied, access_denied_by_unknown_qr, access_denied_unknown_identifier, lift_call_success, lift_call_error, lift_module_access_error, tamper_event, access_granted_by_shared_identifier, access_denied_by_not_valid_shared_identifier, bond_lift_request]
Log key that should be used for filtering
sort object
This model describes available sort options can be used to display logs
asc boolean
Is used ascending order
available_sorting string[]
Possible values: [asc, desc]
List of sort options
locale object
This model describes available languages can be used to display logs
locale string
Possible values: [en, es, ru, uk, pl, nl, tr, fr, da]
Default value: en
Used locale
available_locales string[]
Possible values: [en, es, ru, uk, pl, nl, tr, fr, da]
List of available locales
list_items object[]
List of logs
timestamp int64
Unix Timestamp Date
category string
Possible values: [access, emergency, system, info]
Log category
priority string
Log priority
name object
Log key and name
key string
Log key. It can be used for filtering
text string
Log description
info object
This model provides detailed information about log event
model object
Represents log event raw data
anyOf
MOD2
MOD3
MOD4
MOD5
MOD6
MOD7
MOD8
MOD9
MOD10
MOD11
MOD12
MOD13
MOD14
MOD16
MOD17
MOD18
MOD19
MOD20
MOD21
MOD26
MOD27
MOD28
MOD29
MOD32
MOD33
MOD34
MOD35
status string
Possible values: [checking, downloading, backuping, installing, finishing, error]
Firmware updating event
text string
Human-readable information about event

{
  "list_option": {
    "pagination": {
      "total_items": 18,
      "items_limit": 10,
      "total_pages": 2,
      "current_page": 1
    },
    "filter": {
      "available_filtering": true,
      "is_filtered": true,
      "available_fields": [
        {
          "filter_field": true,
          "available_types": [
            "equal"
          ]
        }
      ],
      "available_values": {
        "category": [
          "access",
          "emergency",
          "system",
          "info"
        ],
        "priority": [
          "critical",
          "high",
          "low",
          "medium"
        ],
        "name": [
          {
            "text": "Unknown identifier",
            "key": "access_denied_by_unknown_card"
          }
        ]
      }
    },
    "sort": {
      "asc": true,
      "available_sorting": [
        "asc",
        "desc"
      ]
    },
    "locale": {
      "locale": "en",
      "available_locales": [
        "en",
        "es",
        "ru",
        "uk",
        "pl",
        "nl",
        "tr",
        "fr",
        "da"
      ]
    }
  },
  "list_items": [
    {
      "timestamp": 1540819272,
      "category": "access",
      "priority": "high",
      "name": {
        "key": "incoming_call",
        "text": "Access denied by web interface"
      },
      "info": {
        "model": {},
        "text": "Lock 1 opened from the web interface"
      }
    }
  ]
}

{
  "list_option": {
    "pagination": {
      "total_pages": 1,
      "items_limit": 10,
      "total_items": 1,
      "current_page": 1
    },
    "filter": {
      "available_filtering": true,
      "available_fields": [
        {
          "available_types": [
            "equal"
          ],
          "filter_field": "priority"
        },
        {
          "available_types": [
            "equal"
          ],
          "filter_field": "category"
        },
        {
          "available_types": [
            "equal"
          ],
          "filter_field": "name"
        }
      ],
      "available_values": {
        "category": [
          "emergency",
          "access",
          "system",
          "info"
        ],
        "priority": [
          "low",
          "critical",
          "medium",
          "high"
        ],
        "name": [
          {
            "text": "SIP registration lost",
            "key": "sip_registration_lost"
          },
          {
            "text": "Unknown identifier",
            "key": "access_denied_by_unknown_card"
          },
          {
            "text": "Wrong input code",
            "key": "access_denied_by_not_valid_input_code"
          },
          {
            "text": "Access granted by remote server",
            "key": "access_granted_by_remote_server_api_call"
          },
          {
            "text": "Missed outgoing call",
            "key": "outgoing_call_missed"
          },
          {
            "text": "Door is not closed too long",
            "key": "door_was_not_closed_too_long"
          },
          {
            "text": "Unknown QR code",
            "key": "access_denied_by_unknown_qr"
          },
          {
            "text": "Lock opened by response device",
            "key": "access_granted_by_call_host"
          },
          {
            "text": "Door was closed",
            "key": "door_was_closed"
          },
          {
            "text": "Lock opened by free access button",
            "key": "lock_was_opened_by_free_access_button"
          },
          {
            "text": "Outgoing call",
            "key": "outgoing_call"
          },
          {
            "text": "Device booted",
            "key": "device_booted"
          },
          {
            "text": "Failed login attempt to the GUI settings",
            "key": "incorrect_login_gui_settings"
          },
          {
            "text": "Entered to GUI settings",
            "key": "successful_login_gui_settings"
          },
          {
            "text": "Incoming call",
            "key": "incoming_call"
          },
          {
            "text": "Door was opened",
            "key": "door_was_opened"
          },
          {
            "text": "Access denied by remote server",
            "key": "access_denied_by_remote_server_api_call"
          },
          {
            "text": "Door sensor opened",
            "key": "door_sensor_was_opened"
          },
          {
            "text": "Not valid face identifier",
            "key": "access_denied_by_not_valid_face_identifier"
          },
          {
            "text": "Failed login attempt to the web interface",
            "key": "incorrect_login_api_call"
          },
          {
            "text": "Not valid identifier",
            "key": "access_denied_by_not_valid_identifier"
          },
          {
            "text": "Access granted",
            "key": "access_granted_by_api_call"
          },
          {
            "text": "Lock opened by identifier",
            "key": "access_granted_by_valid_identifier"
          },
          {
            "text": "The lock is open on alarm",
            "key": "emergency_lock_is_opened"
          },
          {
            "text": "Lock opened by exit button",
            "key": "lock_was_opened_by_exit_btn"
          },
          {
            "text": "General access code entered",
            "key": "access_granted_by_master_code"
          },
          {
            "text": "Lock opened by face identifier",
            "key": "access_granted_by_valid_face_identifier"
          },
          {
            "text": "Door sensor closed",
            "key": "door_sensor_was_closed"
          },
          {
            "text": "Login to the web interface",
            "key": "successful_login_api_call"
          },
          {
            "text": "Outgoing call from web",
            "key": "outgoing_call_web"
          },
          {
            "text": "Tamper triggered",
            "key": "tamper_event"
          },
          {
            "text": "Multi factor access granted",
            "key": "multi_access_granted"
          },
          {
            "text": "Multi factor access denied",
            "key": "multi_access_denied"
          },
          {
            "text": "Identifiers without linkage to user are not allowed",
            "key": "identifiers_without_linkage_to_user_access_denied"
          },
          {
            "text": "Access denied by unknown identifier",
            "key": "access_denied_unknown_identifier"
          },
          {
            "text": "Successful lift call",
            "key": "lift_call_success"
          },
          {
            "text": "Failed to call the lift",
            "key": "lift_call_error"
          },
          {
            "text": "Cannot access lift module",
            "key": "lift_module_access_error"
          },
          {
            "text": "Access granted by shared identifier",
            "key": "access_granted_by_shared_identifier"
          },
          {
            "text": "Access denied by shared identifier",
            "key": "access_denied_by_not_valid_shared_identifier"
          },
          {
            "text": "Lift request",
            "key": "bond_lift_request"
          }
        ]
      }
    },
    "locale": {
      "available_locales": [
        "pl",
        "uk",
        "en",
        "ru",
        "es",
        "nl",
        "tr",
        "fr",
        "da"
      ],
      "locale": "en"
    },
    "sort": {
      "asc": false,
      "available_values": [
        "asc",
        "desc"
      ]
    }
  },
  "list_items": [
    {
      "timestamp": 1608292485815,
      "category": "system",
      "priority": "medium",
      "name": {
        "text": "Login to the web interface",
        "key": "successful_login_api_call"
      },
      "info": {
        "text": "Successful (admin) login to the web interface",
        "model": {
          "account_type": "admin"
        }
      }
    }
  ]
}

Base errors for all entities

Wrong pagination limit
Wrong page number
Wrong filter type
Wrong filter field
Wrong filter format
Wrong filter value
Wrong sort type
Errors appeared only in log entities:
Wrong time format
Wrong time range: 'to' must be greater then 'from'
Errors appeared in other entities:
Wrong sort field

application/json

Schema

error string
Error message

{
  "error": "Administrator rights required"
}

{
  "error": "Wrong pagination limit"
}

{
  "error": "Wrong page number"
}

{
  "error": "Wrong sort type"
}

{
  "error": "Wrong sort field"
}

{
  "error": "Wrong filter type"
}

{
  "error": "Wrong filter field"
}

{
  "error": "Wrong filter value"
}

{
  "error": "Wrong filter format"
}

{
  "error": "Wrong time format"
}

{
  "error": "Wrong time range: 'to' must be greater then 'from'"
}

Unauthorized request. Log In

application/json

Schema
Example (from schema)
Log In

Schema

error string
Error message

{
  "error": "Log In"
}

{
  "error": "Log In"
}

Get logs list​

Access​

Info​

System​

Emergency​

Get logs list

Access

Info

System

Emergency