---
title: "Get Approved Lists"
method: GET
path: "/v2/guest/approved_lists"
tags: ["Approved Lists"]
---

# Get Approved Lists

`GET /v2/guest/approved_lists`

## Request

- Base URL: `https://api.verkada.com`
- URL: `https://api.verkada.com/v2/guest/approved_lists`
- Auth: one of:
  - API key in header `x-verkada-auth`
  - API key in header `x-api-key`

Returns a paginated list of approved lists for the organization.
Optionally filter by site_id to get lists for a specific site.

## Query parameters

- `site_id` string, uuid: Optional site ID to filter approved lists. Omitting will return all lists for the organization.
- `cursor` string: Pagination cursor for retrieving the next page of results.
- `limit` integer: Maximum number of approved lists to return. Default is 100, maximum is 1000.

## Response `200`

OK

- ApprovedListsResponse: Response containing a list of approved lists
  - `cursor` string: Pagination cursor for retrieving the next page of results. Continue paginating while this field is present.
  - `items` ApprovedListItem[], required: List of approved lists.
    - `approved_list_id` string, required: The unique identifier of the approved list.
    - `name` string, required: The name of the approved list.
    - `site_id` string, required: The unique identifier of the site this list is applied to.

---

[API](https://skmtc.dev/verkada/apis/v2-guest-api.md) - [All operations](https://skmtc.dev/verkada/apis/v2-guest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verkada/apis/v2-guest-api/revisions/a951377c525a?raw)