---
title: "Get Access Group"
method: GET
path: "/access/v1/access_groups/group"
tags: ["Access Groups"]
---

# Get Access Group

`GET /access/v1/access_groups/group`

## Request

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

Retrieves an access group specified by its Verkada-defined unique identifier(Group ID). The response is the Access Group Metadata Object for the desired Access Group.

## Query parameters

- `group_id` string, uuid, required: The unique identifier of the Access Group managed by Verkada.

## Response `200`

OK

- AccessGroupObjectMetaResponseV1
  - `group_id` string, uuid: The unique identifier of the Access Group managed by Verkada.
  - `name` string: The unique name of the Access Group provided by the customer.
  - `user_ids` string[]: The list of Verkada-defined user identifiers within the access group.

---

[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)