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

# Get Access Events

`GET /events/v1/access`

## Request

- Base URL: `https://api.verkada.com`
- URL: `https://api.verkada.com/events/v1/access`
- Auth: one of:
  - API key in header `x-verkada-auth`
  - API key in header `x-api-key`

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.dev/verkada/apis/access-api.md) - [All operations](https://skmtc.dev/verkada/apis/access-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verkada/apis/access-api/revisions/11a8c69fd17f?raw)