---
title: "Get Approved List Members"
method: GET
path: "/v2/guest/approved_lists/{approved_list_id}"
tags: ["Approved Lists"]
---

# Get Approved List Members

`GET /v2/guest/approved_lists/{approved_list_id}`

Returns a paginated list of people on a specific approved list.
Excludes expired members.

## Path parameters

- `approved_list_id` string, required

## Query parameters

- `cursor` string — Pagination cursor for retrieving the next page of results.
- `limit` integer — Maximum number of people to return. Default is 100, maximum is 1000.

## Response `200`

OK

- ApprovedListMembersResponse — Response containing people on an approved list
  - `cursor` string — Pagination cursor for retrieving the next page of results. Continue paginating while this field is present.
  - `people` PersonInfo[], required — List of people on the approved list.
    - `address` string — The person's street address.
    - `date_of_birth` string — The person's date of birth in YYYY-MM-DD format.
    - `email` string, required — The person's email address.
    - `expiration_timestamp` string — ISO 8601 formatted expiration time for the approved list entry. This will be shared by all entries corresponding to this person.
    - `external_id` string — Stable external identifier. This can be used to ensure that changes are to the same person as well as ease syncing with an external system. Must be unique to the person within the organization if used.
    - `full_name` string, required — The person's full name.
    - `person_id` string, required — Verkada's internal identifier for the person.
    - `phone_number` string — The person's phone number.

---

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