Access Doors Guide

Overview

The Doors API for Access Control enables our customers to retrieve and control their Verkada-managed doors.

These APIs are great for integrating Verkada with third-party applications that need to control doors or process door events.

API Endpoints

  • Get Doors - Retrieves a list of doors in a given organization
  • Unlock Door as User - Sends a request to unlock a door with door_id as the user with the specified user_id or external_id.
  • Unlock Door as Admin - Sends a request to unlock a door with door_id irrespective of user door access privileges

Using the Doors API

Getting Started

Before Verkada-managed doors can be unlocked using APIs, you must first enable this capability in Verkada Command. Setup instructions can be found in our support article on Unlocking Doors via API.

Example Use Cases

Let end-customers unlock doors from a custom app

Allow your end-customers to unlock Verkada-managed doors through your own applications. For example, fitness or recreation centers may provide their members with a proprietary mobile app to manage their membership, which can also be integrated with Verkada so members can use the app to gain access to your facilities.

Example integration steps for this use case:

  • Step 1 - Retrieve your Verkada-managed doors: Call the Get Doors API to get a list of doors in your organization and their IDs, optionally filtered by Site ID or Door ID.
  • Step 2 (if needed) - Create User in Verkada: When a new user is registered in your app, call the Create User API to create a user account for the new user in Verkada. Optionally label the Verkada user with the ID used in your app by providing an external_id.
  • Step 3 - Unlock door for user: When the user created at step 3 takes an action in your app to unlock a specific door, call the Unlock Door as User API by providing the door ID of the relevant door (obtained in step 1 above) and the Verkada user_id or external_id the user that took the action. Note that the unlock request will only be granted if the user has been given access to the door through an access level in Verkada Command.
  • Step 4 - Monitor events for particular doors: Set up Access Events Webhooks to listen for events at one or more doors obtained at step 1. For example, listen for door open events to confirm that the door at step 2 was actually opened after being unlocked,

Unlock doors from third-party administrative software

Allow third-party administrative software used by your organization to unlock Verkada-managed doors and/or track door events. For example, automate unlocking of doors based on events or activity that occurs in your administrative software.

Example integration steps for this use case:

  • Step 1 - Retrieve your Verkada-managed doors: Call the Get Doors API to get a list of doors in your organization and their IDs, optionally filtered by Site ID or Door ID.
  • Step 2 - Unlock door: When a relevant event occurs in your administrative software, call the Unlock Door as Admin API by providing the door ID of the relevant door (obtained in step 1 above). Note that the unlock request will be granted without respect to any access levels or door schedules, unless there is an active lockdown.
  • Step 3 - Monitor events for particular doors: Set up Access Events Webhooks to listen for events at one or more doors obtained at step 1. For example, listen for door open events to confirm that the door at step 2 was actually opened after being unlocked.