---
title: "Get Access Events"
method: GET
path: "/events/v1/access"
tags: ["Events"]
---

# Get Access Events

`GET /events/v1/access`

Returns events for an organization within a specified time range.

## Query parameters

- `start_time` integer — The start of the time range for requested events. Formatted as a Unix timestamp in seconds. Default value is an hour ago from the current time.
- `end_time` integer — The end of the time range for requested events. Formatted as a Unix timestamp in seconds. Default value is the current time.
- `page_token` string — The pagination token used to fetch the next page of results.
- `page_size` integer — The number of items returned in a single response. Default is 100. Max is 200.
- `event_type` string — One or multiple comma separated values from <code>door_opened</code>, <code>door_rejected</code>, <code>door_granted</code>, <code>door_forced_open</code>, <code>door_held_open</code>, <code>door_tailgating</code>, <code>door_crowd_detection</code>, <code>door_tamper</code>, <code>door_poi_detection</code>, <code>door_initialized</code>, <code>door_armed</code>, <code>door_armed_button_pressed</code>, <code>door_aux_unlock</code>, <code>door_locked</code>, <code>door_unlocked</code>, <code>door_unarmed_event</code>, <code>door_code_entered_event</code>, <code>door_button_press_entered_event</code>, <code>door_lock_state_changed</code>, <code>door_lockdown</code>, <code>door_auxinput_change_state</code>, <code>door_auxinput_held</code>, <code>door_low_battery</code>, <code>door_critical_battery</code>, <code>door_mobile_nfc_scan_accepted</code>, <code>door_mobile_nfc_scan_rejected</code>, <code>door_user_database_corrupt</code>, <code>door_keycard_entered_accepted</code>, <code>door_keycard_entered_rejected</code>, <code>door_code_entered_accepted</code>, <code>door_code_entered_rejected</code>, <code>door_remote_unlock_accepted</code>, <code>door_remote_unlock_rejected</code>, <code>door_press_to_exit_accepted</code>, <code>door_ble_unlock_attempt_accepted</code>, <code>door_ble_unlock_attempt_rejected</code>, <code>door_acu_offline</code>, <code>door_fire_alarm_triggered</code>, <code>door_fire_alarm_released</code>, <code>door_acu_fire_alarm_triggered</code>, <code>door_acu_fire_alarm_released</code>, <code>door_schedule_toggle</code>, <code>door_acu_dpi_cut</code>, <code>door_acu_dpi_short</code>, <code>door_acu_rex_cut</code>, <code>door_acu_rex_short</code>, <code>door_acu_rex2_cut</code>, <code>door_acu_rex2_short</code>, <code>door_acu_auxinput_cut</code>, <code>door_acu_auxinput_short</code>, <code>door_lockdown_debounced</code>, <code>door_lp_presented_accepted</code>, <code>door_lp_presented_rejected</code>, <code>door_apb_double_entry</code>, <code>door_apb_double_exit</code>, <code>all_access_granted</code>, <code>all_access_rejected</code>, <code>door_auxoutput_activated</code>.<code>door_auxoutput_deactivated</code>.<code>door_schedule_override_applied</code>, <code>door_schedule_override_removed</code>.
- `site_id` string — One or multiple comma separated values of site identifiers.
- `device_id` string — One or multiple comma separated values of device identifiers.
- `user_id` string — One or multiple comma separated values of user identifiers.

## Response `200`

OK

- EventsResponseV1
  - `events` Event[] — Events
    - `device_id` string — The unique identifier of the device.
    - `device_type` string — The type of the device.
    - `end_timestamp` string — The time the event ended. Formatted as a Unix timestamp in seconds.
    - `event_id` string — The unique identifier of the event.
    - `event_info` EventInfo
      - `accepted` boolean — Whether the unlock attempt was accepted
      - `auxInputId` string — Identifier of the auxiliary input
      - `auxInputName` string — Name of the auxiliary input
      - `buildingId` string — Identifier of the building
      - `buildingName` string — Name of the building
      - `direction` string — In or out door
      - `doorId` string — Unique identifier of the door
      - `doorInfo` DoorInfo
        - `accessControllerId` string — Unique identifier of the access controller
        - `accessControllerName` string — Name of the access controller
        - `name` string — Name of the door
      - `entityId` string — Identifier of the entity
      - `entityName` string — Name of the entity
      - `entityType` string — Type of the entity
      - `eventType` string — Type of the event
      - `floorId` string — Identifier of the floor
      - `floorName` string — Name of the floor
      - `floors` FloorInfo[] — List of floors
        - `doorId` string — Unique identifier of the door
        - `floorId` string — Unique identifier of the floor
        - `uuid` string — Event ID for the unlock of the floor
      - `inputValue` string — Value of the input
      - `lockdownInfo` LockdownInfo
        - `action` string — Action taken during lockdown
        - `lockdown` Lockdown
          - `enabled` boolean — Whether lockdown is enabled
          - `lockdownId` string — Identifier of the lockdown
          - `message` string — Message associated with the lockdown
          - `name` string — Name of the lockdown
      - `message` string — Event message
      - `organizationId` string — Organization identifier
      - `rawCard` string — Code or card number used in unlock attempt
      - `scenarioInfo` ScenarioInfo
        - `action` string — Action taken during scenario
        - `scenario` Scenario
          - `enabled` boolean — Whether scenario is enabled
          - `name` string — Name of the scenario
          - `scenarioId` string — Identifier of the scenario
          - `scenarioType` string — Type of scenario (HOLD, SECURE, LOCKDOWN, EVACUATE, SHELTER)
      - `siteId` string — Site identifier
      - `siteName` string — Name of the site
      - `type` string — System's name for the event type
      - `userId` string — User identifier
      - `userInfo` UserInfo
        - `email` string — Email address of the user
        - `firstName` string — First name of the user
        - `lastName` string — Last name of the user
        - `name` string — Full name of the user
        - `organizationId` string — Organization ID associated with the user
        - `phone` string — Phone number of the user
        - `userId` string — Unique identifier of the user
      - `userName` string — Name of the user
      - `uuid` string — Unique identifier of the event
    - `event_type` string — The type of the event.
    - `organization_id` string — The unique identifier of the organization.
    - `site_id` string — The unique identifier of the site.
    - `timestamp` string — The time the event occurred. Formatted as a Unix timestamp in seconds.
  - `next_page_token` string — The pagination token used to fetch the next page of results.

---

[API](https://skmtc.net/verkada/apis/api-tokens.md) · [All operations](https://skmtc.net/verkada/apis/api-tokens/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verkada/api-tokens/versions/4a79d2d949a6/schema)