---
title: "Get All Access Scenarios"
method: GET
path: "/access/v1/scenarios"
tags: ["Access Scenarios"]
---

# Get All Access Scenarios

`GET /access/v1/scenarios`

Lists all access scenarios for the organization.
To use this API, you need an API Key with "Read" permission for "Access Scenario Management" endpoints
or an API Key with "Read" permission for "Access Control" endpoints.

## Query parameters

- `scenario_ids` string[] — IDs of scenarios to list.
- `site_ids` string[] — IDs of scoped sites that the scenarios are applied to.
- `types` string[] — Types of scenarios to list (deprecated, use scenario_types).
- `scenario_types` string[] — Types of scenarios to filter by (e.g., LOCKDOWN, EVACUATE, CUSTOM_TYPE). Accepts any string values for pass-through filtering.

## Response `200`

OK

- ScenarioListResponseV1 — Schema for the list scenarios response.
  - `scenarios` ScenarioV1[] — List of scenarios.
    - `door_configurations` DoorConfiguration[] — Detailed door configurations with lock states.
      - `door_id` string, required — ID of the door.
      - `door_lock_state` string, required — Lock state of the door (e.g., ACCESS_CONTROL, LOCKED, UNLOCKED).
    - `doors_to_lock` string[] — IDs of doors the scenario locks.
    - `message` string — Scenario message.
    - `name` string, required — Name of the scenario.
    - `scenario_color` string — Color of the scenario in hex format (e.g., #FF0000).
    - `scenario_id` string, required — Unique ID of the scenario.
    - `scenario_message` string — Additional message for the scenario.
    - `scenario_type` string — Custom scenario type string (e.g., LOCKDOWN, EVACUATE, CUSTOM_TYPE).
    - `site_count` integer, required — Number of sites that the scenario is applied to.
    - `sites` string[] — IDs of scoped sites to which the scenario is applied.
    - `state` 'ACTIVE' | 'INACTIVE', required — Enum for the Scenario State.
    - `type` 'lockdown', required — Enum for the Scenario Type.
    - `user_groups_with_disable_access` string[] — IDs of user groups allowed to release the scenario.
    - `user_groups_with_door_access` string[] — IDs of user groups with access to the doors to which the scenario is applied.
    - `user_groups_with_enable_access` string[] — IDs of user groups allowed to trigger the scenario.

---

[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/revisions/4a79d2d949a6/schema)