requestertypenamedescriptionreporting period typeparameters and descriptionsformats
BEKEYinternalRegistered Devices ReportThe report provides technical information about units that have been uploaded to the system by producer and keys which were uploaded to smartkeys (USB dongle).

The data represented in the report:
- the source information (name of the file, row in the file, position, status, date of uploading, content)
- the unit information (Bluetooth address, software, and hardware version, type)
configured period
EXCEL, JSON
BEKEYinternalBattery Lifetime report

The report for internal usage. Shows how long units work between battery replacements
Available information:
-Battery data (installed - replacement dates, installed - replacement voltage, battery type, loosing power per day, number of days, number of openings)
- Address information
- Unit information (Bluetooth address, type, software version)


*NOTE: The units get into the report if the current value of the battery voltage more than the previous one. Measuring passes each time when the unit was used (opened/closed). Technically the batteries can recover after the unit action. This behavior of batteries combining with the report logic makes the system include the units even though the batteries have not been changed, therefore each address should be checked manually by observing the battery capacity percentage. If it not low enough and the difference between values "was" and "is" of measured voltage not huge - it's probably not the replacement but batteries recover.

The report is always on the current date.
EXCEL, JSON
Construction/renovationproductionUnlocked doors day-end reportThe report is (mostly) relevant to construction companies. The overview of apartments/SmartLocks which haven’t been locked after the end day of work, and who was the last user entered the apartment. This report lets the managers and contractors not to do manually check if each apartment has been locked after the end day of work and to minimize the risk of burglary from apartments during renovation projects due to unlocked doors. The reporе represents the data on the current date.
Available information:
- Address data (address name, status)
- The last open date
- The date of the last open action
- The result of the last open action (success/fail)
- Login of the user
The report is always on the current date.Customer ID * — number (e.g. 1291)
Department ID — Number (e.g. 10)
From time — string (e.g. 12:00:00)
Until time — string (e.g. 12:00:00)
EXCEL, HTML, PDF, JSON
BEKEYinternalInstall Job Status ReportThe report used by BEKEY to get information about all the install jobs which occurred during the set period by the customer.
The report information:
- The install job and install job address information (name, date, status, locksmith company)
- Address information (address name, type, status)
- Unit information (Bluetooth address, type, software version)
configured periodCustomer ID — Number (e.g. 1291)EXCEL, JSON
Copenhagen kommunetechnicalApilog reportThe report shows logs for the period (the one previous day by default).
The report information:
- API name
- log date
- request parameters and response results
- User, customer, IP-address, application information
configured period (by default on the date. report period the previous day)Customer ID * — number (e.g. 1291)EXCEL, JSON
BergentechnicalTenant age Norway reportThe report displays the number of installed units, grouped by tenant age in 10-year intervals (example below).
Report information:
- Age interval
- number of addresses
The report is always on the current date.Customer ID * — number (e.g. 1291)EXCEL, JSON
all customersproductionApplication ReportThe report provides an overall status of operation and usage of BEKEY system.

- Overview of doors accessible to customer grouped by the address type (a public door or a private door )
- Number of units grouped by the unit type (smart lock, smart relay, key box, etc.)
- The addresses where the BEKEY unit has not been used for the last 365 days.
- An overview of the created users divided by roles (regular user or administrator)
- Statistic by users who experienced connection interruption while using BEKEY
- The information about not active users
- The general statistics of using BEKEY by all users of a customer
configured periodCustomer ID * — number (e.g. 1291)
Period to define not active users (in days) — number (days, considered as not active. 180 by default)
HTML, PDF, JSON
BEKEYinternalInstall Job Invoice ReportThe report provides information about the jobs which have been made for the customer. The purpose of the report is to invoice the customer for this provided work.
This report includes the next information:
- Information about the customer which ordered the job and customer who did this job (id, name, locksmith name)
- Install job order, install job and install job address details
- Address details (street name, house number, house letter, type, etc.)
- unit details (type, software version)
- comments
- tool bundles which were used during the job *

Tool bundles - it's a physical (bolts, screws, metal plates, etc.) and not physical (additional time for something) identifier to register what used a locksmith to do the job. It is needed for BEKEY to calculate the price of the job.
configured periodCustomer ID — number (e.g. 1291)
Department ID — Number (e.g. 10)
Locksmith ID — number (e.g. 1463)
Simple view — string true, any other value or empty — false
EXCEL, HTML, JSON
BEKEYinternalAddress Status Report

The report provides an overview of all addresses which match the set configurations:
- is accessible to the customer
- with units/status/type
- located in the area
- mounted before/after

The report shows information about:
- full address (street name, house letter, apartment, type, etc.)
- address status
- type of access
- unit information (id, type, software version, etc.)
- data about customer/user who made the installation

The report is always on the current date.

Accessible By - limits the report by the addresses accessible for any certain customer. The ID of the customer should be entered.

District - limits the report by the addresses located in the particular district. The string should be entered

Postal code - limits the report by the addresses located in the particular postal code or postal codes range. Either a single value or the range of codes split by "-", e.g. 1000 - 1450
Types - limits the report by the addresses which relate to a certain type or several types split by comma. The ID of the type should be entered:
id 1 - APPBLOCK, id 2 - GATE, id 3 - ELEVATOR, id 99 - PRIVATE

Statuses - limits the report by the addresses with a certain status or statuses split by comma. The ID of the status should be entered:
id 0 - NOT_INSTALLED, id 1 - ORDERED, id 10 - INSTALLED, id 30 - ERROR, id 40 - UNINSTALL_ORDERED, id 35 - LOW_BATTERY;

Only with units - set "true" to get the report with only the addresses with units. The default value is "false"
Mounted after and Mounted before - limits the report by the addresses with units installed before or after a certain date accordingly.

EXCEL, JSON
BEKEYinternalUnits ReportThe report provides an overview of all units which have been installed during the configured period. If the installation company is set in the configurations - the only installations of this company will be included in the report.

The report includes information about:
- a unit (id, type, hardware, and software version, battery voltage, signal settings)
- an installation company and user (id, customer name, user login, installation date)
- an address (name, house number, house letter, etc.)
configured periodInstallation company ID — number (e.g. 1463)
First installations only — string true, any other value or empty — false
EXCEL, JSON
BEKEYinternalInactive Customers ReportThe report provides an overview of all customers who are not active (no activity by customer's users during the last 3 months)
The report provides customer ID and the customer name
The report is always on the current date.
EXCEL, JSON
BEKEYinternalAvailable Addresses ReportThe report provides an overview of all addresses(private and public) that is accessible for the customer (addresses that the customer has permission to use)
The report provides the next information:
- address data (street name, house number, house letter, status, type, etc.)
- Bluetooth address of the unit
- whether it's direct access or access to the linked door
The report is always on the current date.Customer ID * — Number (e.g. 1291)EXCEL, JSON
BEKEYinternalPlatforms Statistics ReportThe report provides an overview of all OS types (Android or IOs) and OS version installed on devices used by users of customers during the set period

Information, represented in the report:

- customer data (id, name)
- OS types and versions and the number of users who are using it.
configured period
EXCEL, JSON
BEKEYinternalPublic Addresses ReportThe report provides an overview of all public doors with BEKEY units in the system

Information, represented in the report:
- address data (street name, house number, house letter, status, type, etc.)

- unit information (id, type, software version, battery status, signal settings, etc.)
The report is always on the current date.
EXCEL, JSON
BEKEYinternalInvoice control reportThe report is used for invoicing purposes. It provides information about which customers had access to the unit during the month (for motorlocks and keyboxes) and which customers opened/ordered the unit during the month ( for smart relays). All configured period separates by months. Each xlsx sheet represents one month.

The data represented in the report:
- Bluetooth address
- Customer name and ID
- Unit type in general (motorlock, keybox, relay, strikes)
configured period
EXCEL, JSON
Construction/renovationproductionNeglected Units reportThe report provides an overview of all addresses, accessible for the customer and was not used for periods of 6 and 12 months (are split into two sheets)
Information, represented in the report:
- address data (street name, house number, house letter, status, type, etc.)
- unit information (id, type, software version, battery status, signal settings, etc.)
- the last date of usage
The report is always on the current date.Customer ID — Number (e.g. 1291)
Department ID — Number (e.g. 10)
Customer Name — string (e.g. My customer)
Only units with batteries — string true, any other value or empty — false
EXCEL, HTML, PDF, JSON
BEKEYinternalAddress Match ReportA specific report which can not be ordered. Should not be available for orderingno period

BEKEYinternalMunicipality ReportOne-time report for Luis. Should not be available for orderingno periodCustomer ID * — number (e.g. 1291)
BergenproductionKey Bundle Users Count ReportThe report provides an overview of the number of users with different roles in the keychains of the customer.

Information, represented in the report:
- address data (street name, house number, house letter, status, type, etc.)
- unit information (id, type, software version, battery status, signal settings, etc.)
- the last date of usage
The report is always on the current date.Customer ID — Number (e.g. 1291)EXCEL, JSON
BEKEYinternalSystem Status Per Month ReportThe report provides the statistic about BEKEY solution during the reporting period divided by months

Information, represented in the report:
Number of openings
Number of errors
Opening rate,%
Keys received
J2ME users
Android users
iOS users
Windows Mobile users
SmartKey users
Active users in total
configured period
EXCEL, JSON
BEKEYinternalUnit Usage ReportThe report shows how many days a customer had an opportunity to use a unit that has been installed on the address regardless of who has installed this unit or for which customer initially this address has been accessible. This report is used for invoicing.
The report provides the next information
- address name
- unit data (ID and Bluetooth address)
- start and end date of the period ( a unit will be in the list if it was installed before or during this period)
configured periodCustomer ID * — number (e.g. 1291)
Department ID — Number (e.g. 10)
EXCEL
Copenhagen kommunetechnicalFailed Login Requests reportThe report provides information about failed login attempts which occurred in the system during the set period
Information, represented in the report:
- date of attempted
- login
- type of the error.
configured periodCustomer ID * — number (e.g. 1291)EXCEL, JSON
Copenhagen kommunetechnicalOperations Status reportThe report provides technical information about the status of the BEKEY system of the customer.

The report represents tables with the following information:
- Number of unsuccessful openings (type 101), grouped by address (address name, count of unsuccessful openings)
- Number of unsuccessful openings (type 101), grouped by user group
(name of a user group, count of unsuccessful openings)
- Users who have access to more than 1 key bundle (login, first name, last name, list of key bundle names)
- Number of DNF, grouped by user group
(name of a user group, count of DNF (during the reporting period))
- Median opening times
Calculation of the median opening times for each combination from the following data:
Firmware version 419, between 460 and 480, 481
Mobile device
Unit type
configured period (the period may be limited by the period of storing logs in the server.)Customer ID * — number (e.g. 1291)HTML, PDF, JSON
all customersproductionUser ReportThe report provides a statistic about the experience of users of a customer for the set period:

The report provides information about:
- user (ID, login, first and last name)
- statistic of using the user application (openings, lockings, errors, successful/fail rate)
- the last used device/app/version
- the last login date/location
configured periodCustomer ID * — number (e.g. 1291)
Department ID — Number (e.g. 10)
Active users only — string true, any other value or empty — false
EXCEL, JSON
BEKEYinternalUnit Accounting ReportThe report provides information about all the units which have been installed, uninstalled and replaced in the selected area during a set period.

The sheet "Installed" has the next information:
- Address data (address name, type, status)
- unit data (ID, Bluetooth address, type, hardware, and software version)
- installation data (a locksmith company and user, installation date)

The sheet "unmounted" has the next information:
- Address data (address name, type, status)
- unit data (ID, Bluetooth address, type, hardware, and software version)
- installation data (a locksmith company and user, uninstalling date)

The sheet "replaced" has the next information:
- Address data (address name, type, status)
- removed unit data (ID, Bluetooth address, type, hardware, and software version)
- installed unit data (ID, Bluetooth address, type, hardware, and software version)
- installation data (a locksmith company and user, uninstalling date)
configured periodCountry Name — string (e.g. Danmark)
Zip Ranges — string (e.g. 2000, 2200)
Address Types — string (PRIVATE,APPBLOCK. Separate by a comma if more than one)
Unit Types — string (PRIVATE, PUBLIC_MAX_POWER. Separate by a comma if more than one)
EXCEL, JSON
all customersproductionBattery Replacement reportThe report shows all the addresses of the customer where the batteries replacement jobs occurred during the reporting period (set in the report config).
Available information:
- Address information (name, type, status)
- Unit information (Bluetooth address, type, software version)
- Battery changing date
- Battery voltage after replacement
configured periodCustomer ID * — number (e.g. 1291)
Department ID — Number (e.g. 10)
EXCEL, JSON
PostNordtechnicalpostnord reportThe report was created to evaluate the effects of a trial/pilot with PostNord (Danish postal company).

The report contains a list of addresses and the number of openings, opening failures and average connection time (duration of the open command) by each of address and users included to the keychains, listed in the configuration of the report.

Provided information:
- Address name
- user login
- the number of openings fails, and the average connection time of successful openings
configured periodCustomer ID * — number (e.g. 1291)
Keychain ID * — number (e.g. 12)
EXCEL, JSON
all customersproductionAddress ReportThe report provides a statistic of openings and a general overview of all the addresses accessible to a customer who had units during the reporting period.

The report contains the next information:

- address data (address name, type, status)
- units data (Bluetooth address, unit type, signal strength, software version, battery status, last open date)
- installation history (locksmith company and user, installation date)
- usage statistic (openings, lockings, fails, fail rate)
configured periodCustomer ID * — number (e.g. 1291)
Department ID — Number (e.g. 10)
EXCEL, JSON
BergenproductionKey Bundle Access ReportThe report provides information about which users have access to which key bundles. Each column represents a key bundle (name) and each row represents a user (login).The report is always on the current date.Customer ID * — number (e.g. 1291)EXCEL, JSON
all customersproductionActive Users ReportThe report provides information about users of a customer (if selected) who were using BEKEY application (a particular may be selected web/mobile or all of existing) during the reporting period.

The report contains information about:
- user (id, login, customer)
- applications (type, version)
- the last login using each type of application
configured periodCustomer ID — number (e.g. 1291)
Client systems — string (e.g. PUBLIC,PUBLIC_ANDROID, etc. separate by a comma if more than one)

all customersproductionBattery Health Status report

The report provides information about the addresses accessible for a customer which have a battery capacity lower than a set value (2% by default)

The report contains information about:
- an address (address name, type, status)
- a unit (Bluetooth address, software version, type, last known battery status, predicted battery status on the report date)

NOTE: The list of the addresses in this report depends on the format. PDF contains only those addresses which have battery capacity level below the set critical value. At the same time, the excel version of the report includes all the addresses with the last known capacity. This report always represents the full picture of the battery units. The PDF report is thought to be provided to customers. The excel report is thought to be used by BEKEY internally as it has all the addresses and ignores the critical capacity settings.

The report is always on the current date.Customer ID * — number (e.g. 1291)
Department ID — Number (e.g. 10)
Customer Name — string (e.g. My customer)
Critical Capacity % — number (default value 2)
Split by key bundles — string true, any other value or empty — false
Show battery level percentages in PDF — string true, any other value or empty — false
EXCEL, HTML, PDF, JSON
BEKEYinternalSystem Status ReportThe report provides an overview of the system on the current date.

The "system" sheet:
- the number of users with different roles (administrators, regular users, mobile users)
- the number of openings and fails
- the number of keys

The "mobile" sheet:
- the number of users grouped by each Application type and version

The "units" sheet:
- the number of units grouped by unit software versions
The report is always on the current date.
EXCEL, JSON