How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kontakt.io Device API

The Device resource represents Kontakt.io devices assigned to a particular Kontakt.io Panel account, as well as devices shared with that account from different accounts.

Kontakt.io Device API is one of 30 APIs that Kontakt.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Device. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a changelog, and rate-limit docs.

This API exposes 12 operations across 10 paths, and defines 59 schemas. It is described by OpenAPI 3.2.0, at version 10.

Requests are made against 2 base URLs: https://dm-api.cloud.us.kontakt.io, https://dm-api.cloud.uk.kontakt.io.

12 operations 10 paths 59 schemas 1 DELETE5 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
10
Base URL
https://dm-api.cloud.us.kontakt.io
Authentication
HTTP Bearer, API Key, API Key
Contact
Terms of Service
Resource Areas
1

Authentication & Security 3

Kontakt.io Device API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearer_token). An API key is passed in the header as Api-Key (api_key). An API key is passed in the header as Api-Key (management_api_key). By default, every request must be authenticated.

  • bearer_token — Provide a JWT in the Authorization: Bearer header. This is the standard authentication method for all API requests. Obtain a token via the OAuth2 Client Creden…
  • api_key — Deprecated — do not use for new integrations. This method exists solely for backward compatibility and will be removed in a future release. Use JWT Bearer toke…
  • management_api_key — Special management API Key with additional privileges used by authorized users.

Paths & Operations 12

Across 10 paths, the API surfaces 12 operations — 1 DELETE, 5 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Device 12

The Device resource represents Kontakt.io devices assigned to a particular Kontakt.io Panel account, as well as devices shared with that account from different accounts.

GET
/device
Get Devices
getDevice 16 params → 200
POST
/device/decrypt
Decrypt READALL secure response from device
postDeviceDecrypt 3 params → 200
POST
/device/update
Update a Device
postDeviceUpdate 1 param body → 200204401404422
GET
/device/unassigned/{managerId}deprecated
Get unassigned Devices
getDeviceUnassignedByManagerId 3 params → 200404
POST
/device/{uniqueId}/access
Grant access to the device
postDeviceByUniqueIdAccess 1 param body → 204404422
GET
/device/{uniqueId}/access
Return managers with access to the device
getDeviceByUniqueIdAccess 1 param → 200422
DELETE
/device/{uniqueId}/access/{email}
Revokes access to a device
deleteDeviceByUniqueIdAccessByEmail 2 params → 204404422
POST
/bulk/device-access
Bulk operation to grant or revoke access to devices
postBulkDeviceAccess body → 200404422
GET
/bulk/device-access
Returns status and details for device access bulk process started by the…
getBulkDeviceAccessStatusForAuthorizedManager → 200
GET
/bulk/device-access/{jobKey}
Returns status and details for provided device access bulk process
getBulkDeviceAccessStatus 1 param → 200
POST
/device/sync
Synchronize device
postDeviceSync 1 param body → 200401404422
POST
/device/sync/token
Synchronize device token
postDeviceSyncToken 1 param body → 200401404422

Schemas 59

The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are ConfigBle (12 properties), PowerSavingSettings (9 properties), SearchMeta (9 properties), LocalAlertingSettings (9 properties). Each schema is shown below with its type and property counts.

OccupancyExclusionZones
array
Exclusion zones. Areas excluded from occupancy counting like windows, heaters, etc. Applicable only in static room occupancy. It's a virtual attribute.
ConfigLocksResponse
object
1 property
StitchingPose
object
3 properties 3 required
DeviceMacs
object
Collection of MAC addresses associated with the device.
5 properties
LockDetailsConfirmationId
string
The value included in the DeviceChangedEvent.UPDATED to confirm that a specific configuration has been applied on a device
LocalAlertingSettings
object
Device local alerting settings.
9 properties
DeviceAccessBulkJobResponse
object
5 properties
BeaconConfig
Full beacon-type configuration.
FirmwareInfo
object
Details about device's firmware.
3 properties 3 required
DisplaySettings
object
Device display settings.
4 properties
OccupancyPhysicalSettings
object
Occupancy settings. Only applicable to devices with occupancy capability.
7 properties
LockDetails
object
1 property
HumidityProbe
object
Settings for a humidity probe.
5 properties
DeviceDataRole
string
Type of access granted to this device.
ConfigBle
object
General BLE advertising settings.
12 properties
StitchingPivotWorld
object
Pivot (rotation point) of the image in the world coordinates that are shared between stitched devices. Origin is top left corner.
2 properties 2 required
JobStatus
string
Job status.
TemperatureProbe
object
Settings for a temperature probe.
5 properties
PendingGatewayConfig
Pending Gateway (e.g. Portal Light) Configuration.
ConfigEddystone
object
Eddystone settings.
5 properties
TemperatureProbesSettings
object
Settings for temperature probes.
3 properties
StitchingPairMinimal
object
2 properties 2 required
LowBatterySettings
object
Device low battery settings.
2 properties
DeviceType
string
General type of device.
IrReceiverSettings
object
IR Receiver setting.
3 properties
ConfigButton
object
Button settings.
3 properties
StitchingPivotLocal
object
Pivot (rotation point) of the image in the device image's local coordinates.
2 properties 2 required
DeviceAccessGrantRequest
object
3 properties
DeploymentStatus
string
Current deployment status of this device - e.g. whether is it deployed or not. ENDOFLIFE means the device is not going to be used anymore. Can occur for many r…
OccupancyAllSettings
Occupancy settings. Only applicable to devices with occupancy capability.
IrTransmitterSettings
object
IR Transmitter setting.
3 properties
UpdateDeviceVirtualAttributesRequest
Device Update Virtual Attributes
PendingBeaconConfig
Pending Beacon Configuration.
UpdateDeviceSecureResponseRequest
object
3 properties 3 required
AccelerometerSettings
object
Accelerometer settings.
6 properties
HumidityProbesSettings
object
Settings for humidity probes.
1 property
BleScanSettings
object
BLE scanning setting. Can be used for fingerprinting.
5 properties
PowerSavingSettings
object
Power Saving settings
9 properties
Device
object
DeviceAccessRevokeRequest
object
1 property
SearchMeta
object
Additional information, pagination and metadata about an API response
9 properties
ConfigEid
object
Eddystone-EID settings.
2 properties
ConfigIBeacon
object
iBeacon settings.
4 properties
OccupancyInclusionZones
array
Inclusion zones. Areas included in occupancy counting. Applicable only in seat occupancy. Zone ids must match seat ids from Smart Location system. It's a virtu…
SensorSettings
object
Device sensor settings.
2 properties
DeviceAccessResponse
object
6 properties
Polygon
object
2 properties
DeviceEditableVirtualAttributes
object
Set of read-write editable virtual attributes.
7 properties
UniqueId
string
Unique identifier of a device.
BuzzerSnoozing
object
Buzzer snoozing settings for Temperature Monitor Pro devices. Maps to PID buzzersnoozedurationm (0x917D).
2 properties
UpdatedDate
string
Informs when the object has been updated.
DeviceModel
string
Kontakt.io internal model name of the device. Multiple products may have the same model name. Managed 3rd party devices will all have PARTNERDEVICE.
ApiError
object
5 properties
Dispenser
object
Dispenser settings for UHH dispenser beacons. Maps to PIDs dispensermodelid (0x917E) and dispenserdetectionparams (0x917F). Requires soapdispenser capability a…
2 properties
CreatedDate
string
Informs when the object has been created.
LocationInfo
object
Information about device location.
8 properties
DeploymentInfo
object
Information about device's deployment.
4 properties 1 required
DeviceCategory
string
Category of the device, whether it's a moving (TAG) or static (INFRASTRUCTURE) device.
EditableGatewayConfig
object
Gateway (e.g. Portal Light) settings that can be changed via API
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kontaktio-device-api-openapi.yml Raw ↑

Other APIs Kontakt.io publishes across the network.

Kontakt.io Buildings API
Kontakt.io Campuses API
Kontakt.io Colocations API
Kontakt.io Command API
Kontakt.io Config API
Kontakt.io Device (3rd party) API
Kontakt.io Device (Portal Beam) API
Kontakt.io Device tags API
Kontakt.io Eddystone API
Kontakt.io Entity Integration API
Kontakt.io External Device API
Kontakt.io Firmware API
Where this information came from

This is an independent, third-party profile of Kontakt.io Device API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.