---
title: "Retrieve lists"
method: GET
path: "/v0/lists"
tags: ["Lists"]
---

# Retrieve lists

`GET /v0/lists`

Retrieve filtered lists

## Query parameters

- `entry_type` 'string' | 'user_group' | 'provider_org_unit', required — List type to filter by. One of 'string', 'user_group', 'provider_org_unit'.
- `id` string, uuid — Optional ID (exact match) to filter by
- `name` string — Optional name (exact match) to filter by

## Response `200`

OK

- HandlerTypesGetListResponse
  - `lists` HandlerTypesList[] — List of lists
    - `created_at` string, date-time — List creation time
    - `description` string, required — Description of list
    - `editable` boolean — If the list may be edited. False for system lists.
    - `entry_type` string — Type of entry. Supported values are 'string', 'user_group', 'provider_org_unit'
    - `id` string, uuid, required — List ID
    - `name` string, required — Unique name used to reference the list in MQL
    - `updated_at` string, date-time — List last updated time

---

[API](https://skmtc.net/sublime/apis/sublime-platform-api.md) · [All operations](https://skmtc.net/sublime/apis/sublime-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sublime/sublime-platform-api/revisions/d5df82850357/schema)